MCP server documentation
/docsShort on purpose.
The actionlake MCP server lives at one URL and gives an agent eight tools: help, find_actions, get_action, do, ask, check, cost and account. Add it to Claude Code with one command, or to any MCP client that speaks Streamable HTTP, and sign in with OAuth 2.1 or a bearer key. Everything is also on REST.
claude mcp add --transport http actionlake https://connect.actionlake.com/mcphelp {}
actionlake · 8 tools · 1,000+ connectors · 289,000+ actions
billed: do, ask
free: everything else, and every cached answer
find_actions what can I do?
get_action how exactly do I do it?
do do it
ask answer a question across systems
check will this work? (free)
cost what will it cost?
account tenant · keys · connections · plans- 01QuickstartConnect an agent, run a public action, connect a system, read the receipt.
- 02Connect an agentClaude, ChatGPT, Copilot, Cursor, Gemini, Grok and more: the exact steps for each.
- 03API referenceThe REST twin: same names, same receipts, same price book.
- 04ConnectorsWhat agents can reach, and how a new system joins.
The surface
Eight tools. Named for what an agent wants.
Only two spend money, and they cannot be confused: do is a verb, ask is a question. The other six are free, always, including the dry run.
helporientation, a topic, or "why did that fail?"freefind_actionsplain-language search over 289,000+ actionsfreeget_actionthe schema, output shape, cost and an examplefreedoone action, or several in orderper upstream callaskfetch from several systems and join them; the answer, not the rowsper upstream callcheckdry run: inputs, permissions, connections, cost, what needs a confirmationfreecostspend, forecast, cap headroom, the price bookfreeaccounttenant, keys, connections, plans, schedules, approvals, billingfreeThe agent is the planner. ask takes structured steps and a join, not a sentence; find_actions, get_action and check exist to make writing that plan cheap. REST and MCP are one implementation; a test holds them to it.
Connect
If your agent speaks MCP, you are already integrated.
Claude, ChatGPT, Copilot, Cursor, Gemini, Grok, Codex and any other MCP client take the same URL. Send a key, or sign in on the consent page, which creates a free account on the spot.
- OAuth 2.1 sign-in, or a key in
AuthorizationorX-API-Key - 26 ways in, step by step, on Connect an agent
- 8 tools, however many systems you connect
- 100,000 free calls on the sandbox, no card
For software
Machine-readable, on principle.
We sell infrastructure for software, so the documents that matter are fetchable by software, before you sign anything and without a key.
- api.actionlake.com
/v1/price-bookevery commercial number, as JSON, no key - api.actionlake.com
/openapi.jsonthe REST surface, generated from the same code the tools call - api.actionlake.com
/v1/llms.txtwhat an agent reads on connect: the tools, the pricing, how to start - actionlake.com
/llms.txtthis site, indexed for agents - actionlake.com
/.well-known/actionlake-trust.jsonthe mechanisms, and the absences, machine-readable - actionlake.com
/.well-known/security.txtdisclosure scope and safe harbour
For AI agents
An agent can set itself up.
If you are an agent reading this: you do not need a person or a key to start.
- Connect to
https://connect.actionlake.com/mcpwith no credentials.help,find_actionsandtenant.createneed none. - Call
account {"op": "tenant.create", "name": "…"}. It returns a tenant and its key, shown once. Over REST it isPOST https://api.actionlake.com/v1/account/tenant.create. - Write the key into your own MCP config as
Authorization: Bearer al_…(orX-API-Key) and reconnect. Connect an agent has the exact file for your client. - Or ask your user to sign in: connect without a header, and the client opens the actionlake consent page, which signs them in or creates a free account in one click.
Connecting a vendor that uses OAuth, such as Xero, still needs a person once: register your own app with the vendor, sign in as an admin, and the tokens are stored as a connection. API-key vendors the agent connects itself with connections.create.
# 1 connect with no key: help, find_actions and tenant.create need nonemcp https://connect.actionlake.com/mcp# 2 give yourself a tenantaccount {"op": "tenant.create", "name": "my-agent"} ✓ key: al_… shown once - keep it# 3 put the key in your own MCP config, then reconnectheaders {"Authorization": "Bearer al_…"}# or 3 have your user sign in instead: no header,# the consent page signs them in or creates a free account07Questions
Before the first call.
The questions people ask while they connect, with the answer an agent would give.
How do I add actionlake to Claude Code?01
Run claude mcp add --transport http actionlake https://connect.actionlake.com/mcp, start Claude, and approve the consent screen. No key yet? The consent screen creates a sandbox with 100,000 free calls a month. Then say help {} to see the eight tools.
Does actionlake work with MCP clients other than Claude Code?02
Any MCP client that supports remote servers over Streamable HTTP can add https://connect.actionlake.com/mcp and sign in with OAuth 2.1 (with dynamic client registration) or a bearer key. The Connect an agent page has the steps for each client, and says which ones we have not yet tested. Anything that can make an HTTPS request can use the REST API.
Do I need an API key to start?03
No. Over MCP, the consent screen creates a sandbox account. Over REST, one unauthenticated call to tenant.create returns an account and a key with 100,000 free calls a month. The key is shown once, so keep it.
How does my agent know what an action costs before running it?04
get_action shows each action's cost, and check runs a dry run: it validates inputs, permissions and connections, estimates calls and cost, and says what needs a confirmation. Both are free and send nothing to the vendor.
How do I limit what an agent can do?05
Mint a key for it with allowed_actions (one action, a whole connector, a verb, read-only, or everything), a cap in calls, and a confirm policy: agent, human_for_writes or human. Revoking a key also revokes every key it minted.
What happens when a vendor rate-limits or fails?06
A vendor's 401, 403, 429, 5xx or a timeout is not billed. Reads are cached per action, so repeats do not touch the vendor. Writes are never cached and never retried. Every error says what to do next.
Is there an OpenAPI spec and an llms.txt?07
Yes: an OpenAPI description of the REST API, an llms.txt for agents, a public JSON price book and a machine-readable trust document. Each is linked in the Machine-readable section of this page, and none needs a key.
Ask one question across two systems.
100,000 free calls. No card. Hard caps on every key. Cached answers are free.