OpenAPI
Best when a complete OpenAPI 3.x contract already exists, as JSON or YAML or behind a Scalar documentation page. AlltoMCP discovers operation names, inputs, descriptions, and authentication schemes.
DOCProduct guide
Create a controlled tool surface over an API you already own. AlltoMCP handles discovery, schemas, authentication, MCP transport, and client authorization.
Use the agent prompt library01 · Quickstart
02 · Templates
Templates cover 28 public APIs, from OpenAI, Slack, and Jira to PubMed and ClinicalTrials.gov. Choosing one imports the API’s published contract with a starter set of tools selected, and tells you how to get its credential. A few need a setting first, such as your Zendesk or Jira address; the template says so.
03 · Connector types
Best when a complete OpenAPI 3.x contract already exists, as JSON or YAML or behind a Scalar documentation page. AlltoMCP discovers operation names, inputs, descriptions, and authentication schemes.
For Swagger 2.0 APIs. Upload swagger.json or swagger.yaml, or paste a Swagger UI page such as /swagger/index.html and AlltoMCP finds the spec behind it. Body, form, and typed parameters map to tool inputs.
Paste cURL for one endpoint, import a Postman, Insomnia, or Bruno collection or a HAR recording from your browser, or define methods, paths, inputs, and authentication manually. Ids in recorded paths become parameters.
Upload an introspection JSON schema to generate candidate tools from root fields, or define approved queries and mutations manually for tighter control.
Upload a .proto file and enter where the service runs. Methods with google.api.http annotations call their REST routes; others use the Connect protocol, which Connect servers and Envoy's Connect–gRPC bridge accept (grpc-gateway serves the annotated routes). Streaming methods are skipped.
Upload a WSDL 1.1 file. Each operation of its SOAP 1.1 or 1.2 port becomes a tool that takes the request as JSON; AlltoMCP builds the envelope and returns the response body, or the fault, as JSON.
04 · Tool design
Tool names and descriptions guide the model when deciding whether to call an endpoint. Keep tools narrow, remove destructive operations unless required, and state side effects explicitly. If AI descriptions are on, the workspace can suggest one to start from.
Cancel an unpaid invoice. This action cannot be undone. Requires invoice ID.05 · Toolkits
A toolkit serves tools from several of your servers together, so an agent connects and signs in once. Open Toolkits in the workspace, choose tools from your servers’ published tools, and create it. Each tool is named after its server, such as zendesk_ListTickets, and any name can be changed.
Every call still runs through its own server, with that server’s credentials, limits, and call log. A toolkit has its own tokens and OAuth sign-in, and connects like a server:
https://alltomcp.com/mcp/kit/your-toolkit-slug06 · Authentication
Controls who may discover and invoke tools on a server or toolkit.
Authorizes AlltoMCP when forwarding a tool call to your API.
Upstream credentials are encrypted at rest. A server can store one shared credential, or use each person’s own, which each member sets for themselves. For APIs that use OAuth 2, register an app with the provider and connect through its consent screen; tokens refresh automatically. Environments point the same tools at another deployment, such as staging, with its own credential if you like.
07 · Connect clients
Copy the MCP endpoint from a server’s or toolkit’s Overview and add it as a remote MCP server in your client. The client reads the OAuth discovery metadata, opens the AlltoMCP authorization flow, and receives scoped access after you approve it. Cursor and VS Code install with one click from the same page, and Claude Code with one command.
https://alltomcp.com/mcp/your-connector-slug08 · Static tokens
Each server and toolkit can have multiple named tokens. A token can be limited to read-only tools or to chosen tools, and set to expire. Its secret is shown once when created or rotated; only its hash and display prefix are retained.
{
"mcpServers": {
"my-api": {
"type": "http",
"url": "https://alltomcp.com/mcp/connector-slug",
"headers": {
"X-MCP-Token": "s2m_TOKEN"
}
}
}
}09 · Teams and roles
Every account has a personal workspace. Create a team workspace to share servers and toolkits, and invite people by link with one of four roles. Every change is recorded in the workspace’s audit log, with who made it and how.
Sees servers, toolkits, and activity, and sets their own credential. Clients they connect get only read-only tools.
Also creates and changes servers and toolkits: tools, descriptions, tests, and contract syncs.
Also manages access tokens, environments, OAuth apps, members and invites, and billing, and deletes servers and toolkits.
An admin who can’t be removed, and the only one who can delete the workspace.
10 · API keys
Scripts and CI can manage servers, tools, and tokens through the same API the workspace uses. Create a personal API key under Account → API keys; it acts as you, with your role in each workspace. Read-only keys can only read, keys can expire, and changes made with one show in the audit log.
curl https://alltomcp.com/api/connectors \
-H "Authorization: Bearer $ALLTOMCP_API_KEY" \
-H "X-AlltoMCP-Workspace: <team workspace id>"11 · Plans and limits
Every workspace starts on the free plan. Plans set how many MCP servers and toolkits a workspace can have, how many tool calls it can make each calendar month (UTC), and how many members a team workspace can have, counting pending invites. Every feature is on every plan.
At a limit, creating another server or toolkit, or inviting another member, is refused with a message naming the limit, and tool calls past the monthly allowance return an error the agent can relay. A workspace’s plan and usage are under Billing in the workspace.
12 · Troubleshooting
ALLOWED_HOSTS, set PUBLIC_BASE_URL to the same HTTPS origin, then redeploy.CREDENTIAL_ENCRYPTION_KEY. Then save the upstream credential again so it is encrypted with the active key.supabase/schema.sql before relying on durable records.