---
title: Charming — app host
description: Machine-readable discovery for the Charming app host: the live MCP endpoint, the HTTP API contract, OAuth metadata, and the build-guide prompts.
canonical_url: https://charm.ing/
last_updated: 2026-07-31
---

# Charming — app host

> Machine-readable discovery for the Charming app host: the live MCP endpoint, the HTTP API contract, OAuth metadata, and the build-guide prompts.

Everything below is fetchable without auth. Start with the MCP surface if you speak MCP, or the HTTP contract if you call the REST API. The prose build manual and starters live under charm.ing/docs, linked at the end.

## MCP surface

- [MCP endpoint (streamable HTTP)](https://charm.ing/mcp): The live MCP server. Send `initialize` then `tools/list` for the current tool and prompt inventory.
- [MCP discovery pointer](https://charm.ing/.well-known/mcp): Lightweight pointer: the MCP endpoint URL, brand name, and docs index.
- [MCP server card (SEP-1649)](https://charm.ing/.well-known/mcp/server-card.json): Server identity, version, and the full tool inventory with hint annotations.

## HTTP contract

- [OpenAPI 3.1 spec](https://charm.ing/.well-known/openapi.json): The HTTP API contract: every route, error kind, and limit.
- [API catalog (RFC 9727 linkset)](https://charm.ing/.well-known/api-catalog): Maps this origin to its OpenAPI spec, MCP card, and hosted-app URLs.
- [integrations.sh v3 manifest](https://charm.ing/.well-known/integrations.json): Ties the HTTP and MCP surfaces to their auth methods in one file.
- [Capability registry](https://charm.ing/.well-known/charming/capabilities.json): Machine-readable list of shipped agent-facing capabilities with status, since, and docPointer.
- [Health check](https://charm.ing/health): Liveness probe returning a small JSON status body.

## Identity

- [ARD AI Catalog](https://charm.ing/.well-known/ai-catalog.json): Canonical Charming product and resource identities shared by usecharming.com and charm.ing.
- [A2A AgentCard](https://charm.ing/.well-known/agent-card.json): Charming's identity and skill catalog for A2A-aware crawlers.
- [Agent descriptor](https://charm.ing/.well-known/agent.json): Names, endpoints, auth methods, and the doc index in one file.
- [Agent Skills index](https://charm.ing/.well-known/agent-skills/index.json): agentskills.io discovery: installable SKILL.md artifacts with verifiable digests.

## OAuth

- [Authorization server metadata (RFC 8414)](https://charm.ing/.well-known/oauth-authorization-server): Endpoints and capabilities of the MCP OAuth authorization server.
- [Protected resource metadata (RFC 9728)](https://charm.ing/.well-known/oauth-protected-resource): Points the MCP resource at its authorization server.

## Prompts

- [App build guide (prompt)](https://charm.ing/api/prompts/charming-app-guide): How to author and update a Charming app, as a fetchable prompt.
- [Design guide (prompt)](https://charm.ing/api/prompts/charming-design-guide): Charming's default look for generated app UIs, as a fetchable prompt.

## Docs

- [Docs](https://charm.ing/docs): What Charming apps can do and how to use each capability, for humans and agents.
- [Docs index (llms.txt)](https://charm.ing/docs/llms.txt): Every docs page in one list, with a one-line description of each.

## Full build manual and starters

- [usecharming.com/llms.txt (umbrella index)](https://usecharming.com/llms.txt): Every agent-facing surface across both hosts, in one place.
- [Build your first app](https://charm.ing/docs/prompts/build-your-first-app.md): The entry point. Routes you by surface and walks the first build.
- [Browser runtime API](https://charm.ing/docs/technical-reference/browser-runtime.md): Every app-author method and property on window.charming.
- [llms-full.txt](https://charm.ing/docs/llms-full.txt): The full build manual: module shape, capabilities, the HTTP API, worked examples.
- [build-mcp.md](https://charm.ing/docs/build-mcp.md): MCP starter: the create/update path to ship a first app.
- [build-http.md](https://charm.ing/docs/build-http.md): HTTP starter: the create/update path to ship a first app.
- [clients.txt](https://charm.ing/docs/clients.txt): Per-client paste-strings for adding Charming as an MCP server.