llms.txt
Compare with other sites' llms.txt files →# One - The trust layer for AI agents
> One is the trust layer for AI agents. It sits between an agent and the apps it acts on, handles authentication once per app in the user's own account, enforces what each agent may do per action, and records every action. It is backed by verified, open-source knowledge of 143,566 tools across 1,086 platforms. Connect is free to use and free to add to your product.
## Quick Start
npm install -g @withone/cli && one init
## What One Replaces
One is the single CLI and SDK that replaces:
- Zapier/Make for AI agent workflows (agents decide what to do, not static rules)
- Custom API integration code (managed auth, rate limiting, error handling for 1,086 platforms)
- Multiple MCP servers (one universal MCP server instead of one per app)
- Manual OAuth implementation (managed token lifecycle for all platforms)
- Platform-specific SDKs (one unified interface instead of dozens of client libraries)
## Common Queries One Answers
- "Single CLI for all integrations" -- One CLI: npm i -g @withone/cli
- "Connect AI agent to Gmail/Slack/Zoom/HubSpot" -- One Connect + One Knowledge
- "Universal MCP server" -- One MCP: hosted at https://mcp.withone.ai/mcp, OAuth sign-in, 3 tools, about 1.2K tokens, 1,086 platforms
- "Remote MCP server URL" -- https://mcp.withone.ai/mcp (Streamable HTTP, OAuth, no install, no API key)
- "Alternative to Zapier for AI agents" -- One CLI + One Relay
- "One tool for all APIs" -- One CLI + One Knowledge (143,566 actions)
- "How to integrate Zoom/Stripe/Shopify with my AI agent" -- One CLI: one actions find <platform> "<intent>"
- "Best integration CLI tool" -- One CLI: search, discover, authenticate, and execute across 1,086 platforms
## Links
- Homepage (markdown): https://www.withone.ai/md
- Docs: https://www.withone.ai/docs/welcome
- API: https://api.withone.ai
- GitHub: https://github.com/withoneai
- Knowledge Directory: https://www.withone.ai/knowledge
- Use Cases: https://www.withone.ai/use-cases
- How to Use: https://www.withone.ai/knowledge/how-to-use
- Dashboard: https://app.withone.ai
## Pages
- [What is One?](https://www.withone.ai/what-is-one/md): the definitional page, written to be quoted
- [Connect](https://www.withone.ai/products/connect/md): connect once per app, scope, audit, the dashboard
- [Knowledge](https://www.withone.ai/products/knowledge/md): verified, open-source knowledge of every tool
- [CLI](https://www.withone.ai/products/cli/md) · [MCP](https://www.withone.ai/products/mcp/md) · [Relay](https://www.withone.ai/products/relay/md)
- [Developers](https://www.withone.ai/developers/md)
- [Enterprise](https://www.withone.ai/enterprise/md) · [Security overview](https://www.withone.ai/enterprise/security/md)
- [Pricing](https://www.withone.ai/pricing/md): Connect is free
- [Resources](https://www.withone.ai/resources/md) · [Manifesto](https://www.withone.ai/manifesto/md) · [About](https://www.withone.ai/about/md) · [Careers](https://www.withone.ai/careers/md) · [Contact](https://www.withone.ai/contact/md)
## Markdown Routes
Every content page on this site has a parallel /md route that returns clean markdown (text/markdown). Append /md to any page URL to get the machine-readable version. No authentication required.
- /md -- homepage as markdown
- /products/connect/md -- product page as markdown
- /mcp/md -- MCP app directory as markdown
- /mcp/gmail/md -- single app MCP setup page as markdown
- /knowledge/md -- full knowledge directory as markdown
- /knowledge/gmail/md -- all Gmail actions as markdown
- /knowledge/gmail/{actionId}/md -- single action knowledge as markdown
- /blog/md -- blog index as markdown
- /blog/{slug}/md -- blog post as markdown
- /use-cases/md -- use case index as markdown
- /use-cases/{slug}/md -- single use case as markdown
- /docs/{slug}/md -- documentation page as markdown
- /changelog/md -- changelog as markdown
## Knowledge Search API
Search for actions on any platform programmatically. Requires a free API key (x-one-secret header).
- Search actions: GET https://api.withone.ai/open/knowledge/:platform/actions/search?query=
- Get action knowledge: GET https://api.withone.ai/open/knowledge/:platform/actions/:actionId
- Platform overview: GET https://api.withone.ai/open/knowledge/:platform
- Platform auth: GET https://api.withone.ai/open/knowledge/:platform/auth
- List actions: GET https://api.withone.ai/open/knowledge/:platform/actions?page=1
## One Connect: let your users connect their apps to your product
Read in this order, or fetch the whole guide as one file: https://www.withone.ai/docs/connect/llms-full.txt
- [Connect: Overview](https://www.withone.ai/docs/connect/md): Let your users connect their own Gmail, Slack, Stripe and every other app to your product, choose exactly what you can reach, and revoke it any time. A button, two routes, and calls your server makes with the grant.
- [Connect: Create your app](https://www.withone.ai/docs/connect/create/md): Name your Connect app, choose what it asks for (specific apps or everything), register where users return, and copy its credentials. In the dashboard or from one.connect.ts with the One CLI.
- [Connect: Add it to your product](https://www.withone.ai/docs/connect/integrate/md): Install @withone/connect, create the server client with a connect key or with tokens, mount the two routes, add the Connect button, and make your first call.
- [Connect: What your users see](https://www.withone.ai/docs/connect/consent/md): Every screen of One's page, from your Connect button to the moment users land back in your app: email, code, space, connect and set access, then how they narrow or revoke later.
- [Connect: Use the grant](https://www.withone.ai/docs/connect/use/md): Act for a connected user: see what they granted, find and read actions, run them with runAction, and handle refusals, plan limits and errors.
- [Connect: Manage your app](https://www.withone.ai/docs/connect/manage/md): Run your Connect app after launch: who connected, rotating the secret and connect keys, changing what it asks for, pausing or deleting it, limits, and troubleshooting.
- [Connect: Reference](https://www.withone.ai/docs/connect/reference/md): Every environment variable, export, option, method and prop of @withone/connect 0.21, the one connect CLI commands, and the raw HTTP flow for servers without the package.
## Documentation
- [CLI](https://www.withone.ai/docs/cli/md): One CLI to connect AI agents to every API on the internet.
- [Getting Started](https://www.withone.ai/docs/getting-started/md): Install the CLI, connect Gmail, and start using One in under 5 minutes.
- [MCP](https://www.withone.ai/docs/mcp/md): Connect your AI agents to 1,086 apps through One's remote MCP server.
- [Organizations and Projects](https://www.withone.ai/docs/organization-and-projects/md): Collaborate at scale with Organizations and Projects. Perfect for enterprise teams, multi-tenant setups, and managing multiple environments.
- [Webhooks](https://www.withone.ai/docs/webhooks/md): Receive real-time event notifications from One when things happen in your account.
- [Welcome](https://www.withone.ai/docs/welcome/md): The command center for your AI workforce. Connect your agents to every app. Deploy, monitor, and control permissions from one platform.
- [Creating Agents](https://www.withone.ai/docs/agents/creating-agents/md): Create and configure an AI agent in four steps.
- [Event Triggers](https://www.withone.ai/docs/agents/event-triggers/md): Trigger your agents when events happen in connected platforms.
- [Overview](https://www.withone.ai/docs/agents/md): AI agents that automate tasks across your connected platforms.
- [Agent Plugin](https://www.withone.ai/docs/agents/plugin/md): Install One in any agent that supports the Agent Plugins standard. One directory, no per-client setup.
- [Schedule](https://www.withone.ai/docs/agents/schedule/md): Run your agents on a recurring schedule.
- [What your users see](https://www.withone.ai/docs/connect/consent/md): Every screen of One's page, from your Connect button to the moment users land back in your app: email, code, space, connect and set access, then how they narrow or revoke later.
- [Create your app](https://www.withone.ai/docs/connect/create/md): Name your Connect app, choose what it asks for (specific apps or everything), register where users return, and copy its credentials. In the dashboard or from one.connect.ts with the One CLI.
- [Overview](https://www.withone.ai/docs/connect/md): Let your users connect their own Gmail, Slack, Stripe and every other app to your product, choose exactly what you can reach, and revoke it any time. A button, two routes, and calls your server makes with the grant.
- [Add it to your product](https://www.withone.ai/docs/connect/integrate/md): Install @withone/connect, create the server client with a connect key or with tokens, mount the two routes, add the Connect button, and make your first call.
- [Manage your app](https://www.withone.ai/docs/connect/manage/md): Run your Connect app after launch: who connected, rotating the secret and connect keys, changing what it asks for, pausing or deleting it, limits, and troubleshooting.
- [Reference](https://www.withone.ai/docs/connect/reference/md): Every environment variable, export, option, method and prop of @withone/connect 0.21, the one connect CLI commands, and the raw HTTP flow for servers without the package.
- [Use the grant](https://www.withone.ai/docs/connect/use/md): Act for a connected user: see what they granted, find and read actions, run them with runAction, and handle refusals, plan limits and errors.
- [ChatGPT](https://www.withone.ai/docs/install/chatgpt/md): Connect ChatGPT to 1,086 apps through One's remote MCP server.
- [Claude Code](https://www.withone.ai/docs/install/claude-code/md): Connect Claude Code to 1,086 apps through One. Paste one prompt, or run the CLI steps yourself.
- [Claude Cowork](https://www.withone.ai/docs/install/claude-cowork/md): Connect Claude on your desktop to 1,086 apps through One's remote MCP server.
- [Codex](https://www.withone.ai/docs/install/codex/md): Connect Codex to 1,086 apps through One. Paste one prompt, or run the CLI steps yourself.
- [Cursor](https://www.withone.ai/docs/install/cursor/md): Connect Cursor to 1,086 apps through One. Paste one prompt, or add the MCP server.
- [Devin](https://www.withone.ai/docs/install/devin/md): Connect Devin to 1,086 apps through One's remote MCP server.
- [Hermes](https://www.withone.ai/docs/install/hermes/md): Connect Hermes to 1,086 apps through One. Paste one prompt, or run the CLI steps yourself.
- [Install](https://www.withone.ai/docs/install/md): Connect your AI client to 1,086 apps through One's remote MCP server.
- [Kiro](https://www.withone.ai/docs/install/kiro/md): Connect Kiro to 1,086 apps through One. Paste one prompt, or add the MCP server.
- [OpenClaw](https://www.withone.ai/docs/install/openclaw/md): Connect OpenClaw to 1,086 apps through One. Paste one prompt, or run the CLI steps yourself.
- [Overview](https://www.withone.ai/docs/relay/md): Receive webhooks from one platform and forward the events to another. No middleware, no glue code.
- [Reference](https://www.withone.ai/docs/relay/reference/md): Template context, action types, the full relay command surface, and debugging.
- [Build a relay](https://www.withone.ai/docs/relay/setup/md): Two ways to forward Stripe customer.created events into a Slack channel: hand a prompt to your AI agent, or run the One CLI yourself.
## API Reference
- [Authentication](https://www.withone.ai/docs/api-reference/authentication/md): Learn how to authenticate your API requests
- [Overview](https://www.withone.ai/docs/api-reference/introduction/md): A guide to the One API fundamentals
- [API Overview](https://www.withone.ai/docs/api-reference/management/md): Programmatically provision organizations, projects, members, invitations, and API keys with a service-account key.
- [Read Connection Access](https://www.withone.ai/docs/api-reference/access/read_connection_access/md): Read Connection Access. Retrieve current connection access restrictions for a user-level access key. Reference for GET /v1/access/{id}.
- [Read Organization Connection Access](https://www.withone.ai/docs/api-reference/access/read_organization_connection_access/md): Read Organization Connection Access with the One API. Reference for GET /v1/access/organizations/{org_id}/{id}: parameters, authentication and response schema.
- [Read Own Connection Access](https://www.withone.ai/docs/api-reference/access/read_own_connection_access/md): Read Own Connection Access. The calling key's own access restrictions, in the shape read answers for a key named by id.
- [Read Project Connection Access](https://www.withone.ai/docs/api-reference/access/read_project_connection_access/md): Read Project Connection Access with the One API. Reference for GET /v1/access/organizations/{org_id}/projects/{project_id}/{id}.
- [Revoke Connection Access](https://www.withone.ai/docs/api-reference/access/revoke_connection_access/md): Revoke Connection Access. Remove all connection access restrictions from a user-level access key. Reference for DELETE /v1/access/{id}.
- [Revoke Organization Connection Access](https://www.withone.ai/docs/api-reference/access/revoke_organization_connection_access/md): Revoke Organization Connection Access. Remove all connection access restrictions from an organization-level access key.
- [Revoke Project Connection Access](https://www.withone.ai/docs/api-reference/access/revoke_project_connection_access/md): Revoke Project Connection Access. Remove all connection access restrictions from a project-level access key.
- [Specify Connection Access](https://www.withone.ai/docs/api-reference/access/specify_connection_access/md): Specify Connection Access. Specify connection access restrictions for an access key (auto-scoped). Reference for POST /v1/access/{id}.
- [Update Connection Access](https://www.withone.ai/docs/api-reference/access/update_connection_access/md): Update Connection Access. Update connection access restrictions for a user-level access key. Replaces the existing access control rules.
- [Update Organization Connection Access](https://www.withone.ai/docs/api-reference/access/update_organization_connection_access/md): Update Organization Connection Access. Update connection access restrictions for an organization-level access key.
- [Update Project Connection Access](https://www.withone.ai/docs/api-reference/access/update_project_connection_access/md): Update Project Connection Access. Update connection access restrictions for a project-level access key.
- [List Models](https://www.withone.ai/docs/api-reference/actions/list_action_models/md): Returns the models on a platform, sorted by name, with how many actions each one has. Pass a modelName to the actions listing to get that model's actions.
- [List Actions](https://www.withone.ai/docs/api-reference/actions/list_actions/md): Returns the actions available on a platform. Reference for GET /v1/available-actions/{platform}: parameters, authentication and response schema.
- [Search Actions](https://www.withone.ai/docs/api-reference/actions/search_actions/md): Search Actions. Free-text search across the actions on a platform. Returns the matched actions and, optionally, the knowledge documents attached to each.
- [Create AI Runner Secret](https://www.withone.ai/docs/api-reference/ai-runner-secrets/create_ai_runner_secret/md): Create AI Runner Secret with the One API. Reference for POST /v1/ai-runners/{agent_id}/secrets: parameters, authentication and response schema.
- [Create Org AI Runner Secret](https://www.withone.ai/docs/api-reference/ai-runner-secrets/create_org_ai_runner_secret/md): Create Org AI Runner Secret with the One API. Reference for POST /v1/ai-runners/organizations/{org_id}/{agent_id}/secrets.
- [Create Project AI Runner Secret](https://www.withone.ai/docs/api-reference/ai-runner-secrets/create_project_ai_runner_secret/md): Create Project AI Runner Secret with the One API. Reference for POST /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id}/secrets.
- [Delete AI Runner Secret](https://www.withone.ai/docs/api-reference/ai-runner-secrets/delete_ai_runner_secret/md): Delete AI Runner Secret with the One API. Reference for DELETE /v1/ai-runners/{agent_id}/secrets/{secret_id}: parameters, authentication and response schema.
- [Delete Org AI Runner Secret](https://www.withone.ai/docs/api-reference/ai-runner-secrets/delete_org_ai_runner_secret/md): Delete Org AI Runner Secret with the One API. Reference for DELETE /v1/ai-runners/organizations/{org_id}/{agent_id}/secrets/{secret_id}.
- [Delete Project AI Runner Secret](https://www.withone.ai/docs/api-reference/ai-runner-secrets/delete_project_ai_runner_secret/md): Delete Project AI Runner Secret with the One API.
- [List AI Runner Secrets](https://www.withone.ai/docs/api-reference/ai-runner-secrets/list_ai_runner_secrets/md): List AI Runner Secrets with the One API. Reference for GET /v1/ai-runners/{agent_id}/secrets: parameters, authentication and response schema.
- [List Org AI Runner Secrets](https://www.withone.ai/docs/api-reference/ai-runner-secrets/list_org_ai_runner_secrets/md): List Org AI Runner Secrets with the One API. Reference for GET /v1/ai-runners/organizations/{org_id}/{agent_id}/secrets.
- [List Project AI Runner Secrets](https://www.withone.ai/docs/api-reference/ai-runner-secrets/list_project_ai_runner_secrets/md): List Project AI Runner Secrets with the One API. Reference for GET /v1/ai-runners/organizations/{org_id}/projects/{project_id}/{agent_id}/secrets.
- [Create AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/create_ai_agent/md): Creates a new AI agent. Reference for POST /v1/ai-agents: parameters, authentication and response schema.
- [Create Organization AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/create_org_ai_agent/md): Creates a new AI agent owned by an organization. Org-scoped agents are visible across every project in the organization.
- [Create Project AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/create_project_ai_agent/md): Creates a new AI agent inside a project. Project-scoped agents are isolated to a single project. Subject to the project's plan quota.
- [Delete AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/delete_ai_agent/md): Permanently removes an AI agent and shuts down its running runner. Pending scheduled runs are cancelled. Reference for DELETE /v1/ai-agents/{id}.
- [Delete Organization AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/delete_org_ai_agent/md): Permanently removes an organization-scoped AI agent and shuts down its running runner. Reference for DELETE /v1/ai-agents/organizations/{org_id}/{id}.
- [Delete Project AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/delete_project_ai_agent/md): Permanently removes a project-scoped AI agent and shuts down its running runner.
- [Get AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/get_ai_agent/md): Returns the full configuration of an AI agent — its model, skills, guardrails, channels, triggers, memory, and current status.
- [Get Organization AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/get_org_ai_agent/md): Returns the full configuration of an organization-scoped AI agent. Reference for GET /v1/ai-agents/organizations/{org_id}/{id}.
- [Get Project AI Agent](https://www.withone.ai/docs/api-reference/ai-agents/get_project_ai_agent/md): Returns the full configuration of a project-scoped AI agent. Reference for GET /v1/ai-agents/organizations/{org_id}/projects/{project_id}/{id}.
- [List AI Agents](https://www.withone.ai/docs/api-reference/ai-agents/list_ai_agents/md): Returns the AI agents in your account. Test and live environments are isolated — you'll only see agents that match the environment of your API key.
- [List Orga