# Funnel One Developers

> The Funnel One REST API and MCP server. Every caller gets the same rules: a credential acts within the role your workspace admin set.

- REST API base URL: https://app.funnelone.ai/api/v1
- API version: v1 (additive changes only; a removal gets 6 months of notice)
- OpenAPI document: https://dev.funnelone.ai/openapi/v1.json
- MCP server (preview, not live yet): https://app.funnelone.ai/mcp
- Connect an AI agent (instructions for the agent to follow): https://dev.funnelone.ai/agent-setup/prompt.md
- Status: https://status.funnelone.ai

## Get started

- [Quickstart](https://dev.funnelone.ai/get-started/quickstart/): Send your first lead to the REST API with an API key, or connect an AI client to the MCP server.
- [Authentication](https://dev.funnelone.ai/get-started/authentication/): API keys today; OAuth 2.1 sign-in for AI clients in preview. How each credential is sent, what it can do and when it stops working.
- [Scopes](https://dev.funnelone.ai/get-started/scopes/): Every scope a credential can carry, generated from the permission catalog the app's roles use.

## REST API

- [REST API overview](https://dev.funnelone.ai/rest/): What the Funnel One REST API does today, and what is coming: the live lead and motion endpoints, and the planned resources.
- [API reference](https://dev.funnelone.ai/rest/reference/): The Funnel One REST API reference, rendered from its OpenAPI 3.1 document. (coming with B8a; not written yet)
- [Limits, paging, idempotency](https://dev.funnelone.ai/rest/limits/): Rate limits, idempotency keys and request size for the REST API and the MCP server, and the paging that is coming.
- [Errors](https://dev.funnelone.ai/rest/errors/): Every error the REST API and the MCP server return today, what each means and how to fix it.
- [Webhooks](https://dev.funnelone.ai/rest/webhooks/): Signed outbound webhooks: the event catalog and how to verify a signature. (coming with B9; not written yet)
- [SDKs](https://dev.funnelone.ai/rest/sdks/): TypeScript and Python SDKs generated from the OpenAPI document. (coming with B10; not written yet)

## MCP

- [MCP overview](https://dev.funnelone.ai/mcp/): The Funnel One MCP server: one URL, your AI client signs in as you, and it can never do more than your role allows. (preview: built, not live yet)
- [Connect a client](https://dev.funnelone.ai/mcp/connect/): Connect Claude, Claude Code, ChatGPT, Cursor, VS Code with Copilot, Codex or any MCP client to the Funnel One MCP server. (preview: built, not live yet)
- [Tool reference](https://dev.funnelone.ai/mcp/tools/): Every tool the Funnel One MCP server exposes, with the scopes each one needs. (preview: built, not live yet)
- [External agents](https://dev.funnelone.ai/mcp/external-agents/): How another company's agent will join one shared channel and talk to Funnel One only. Written for both sides. (coming soon: not live yet)

## Resources

- [Cookbook](https://dev.funnelone.ai/resources/cookbook/): Worked recipes against the Funnel One API: push leads from your own signup form, start a motion from your systems, and what is coming.
- [Changelog](https://dev.funnelone.ai/resources/changelog/): Every change to the Funnel One API, generated from the OpenAPI diff. (coming with B8a; not written yet)

## Policies

- [Versioning policy](https://dev.funnelone.ai/resources/versioning/): How the Funnel One API changes. The major version is in the URL, v1 only grows, and a removal gets 6 months' notice.