# Documentation

webmcp.fast gives a local MCP server a stable, authenticated URL, `https://<handle>.webmcp.fast/<device>/<server>/mcp`, that any remote-MCP client can use. All of this documentation is public, and every page is also available as Markdown: send `Accept: text/markdown` or add `.md` to the path.

## Guides

- [Quickstart](https://webmcp.fast/docs/quickstart): install the daemon, pair your machine, attach a server, connect an agent.
- [Agent-driven setup](https://webmcp.fast/docs/agents): the same thing done by a coding agent on the user's behalf, and what a cloud agent without a shell can do.
- [API conventions](https://webmcp.fast/docs/api): starting without a key, versioning, the deprecation policy, rate-limit headers and the JSON error format.
- [Security model](https://webmcp.fast/docs/security-model): the three trust relationships, what each credential can reach, and what is logged.

## Reference for agents and tools

- [llms.txt](https://webmcp.fast/llms.txt): summary, when to use this service, and exactly how to proceed.
- [Agent instructions](https://webmcp.fast/agent-instructions.md): the same guidance as a standalone file.
- [Agent skill](https://webmcp.fast/.well-known/agent-skills/set-up-webmcp-fast/SKILL.md): `SKILL.md` for getting a user's local MCP server online.
- [OpenAPI 3.1](https://webmcp.fast/openapi.json): the HTTP API, with OAuth security schemes and scopes.
- [API catalog](https://webmcp.fast/.well-known/api-catalog) (RFC 9727) and [ai-catalog](https://webmcp.fast/.well-known/ai-catalog.json).
- [MCP server card](https://webmcp.fast/.well-known/mcp/server-card.json) for the management MCP server at `https://webmcp.fast/mcp`.
- [auth.md](https://webmcp.fast/auth.md): how an agent obtains a credential.
- OAuth discovery: [authorization server metadata](https://webmcp.fast/.well-known/oauth-authorization-server).

## Management MCP server

`POST https://webmcp.fast/mcp` speaks MCP over Streamable HTTP. Its tools:

- `check_handle` (anonymous): Check whether a handle (the <handle> in https://<handle>.webmcp.fast) is valid and still available to claim.
- `start_setup` (anonymous): Begin setting up webmcp.fast for a user from an agent that has no shell. Returns the exact commands the user runs on their machine and what to expect at each step. The user still signs in and approves the device in their own browser.
- `setup_status` (anonymous): Report how far a setup started with start_setup has got: waiting for the human to approve, device paired, server attached, device online.
- `list_devices` (OAuth scope `manage`): List the signed-in user's handles, their devices, whether each device is online, and the MCP servers each one offers.
- `connect_url` (OAuth scope `manage`): Return the connector URL, https://<handle>.webmcp.fast/<device>/<server>/mcp, for one server on one of the signed-in user's devices, with the steps to add it to Claude, ChatGPT or Grok.

## Policies

[Pricing](https://webmcp.fast/pricing), [security](https://webmcp.fast/security), [privacy](https://webmcp.fast/privacy), [terms](https://webmcp.fast/terms), [about](https://webmcp.fast/about), [contact](https://webmcp.fast/contact).