Skip to content

DOCProduct guide

From API to
MCP server.

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 library

Publish your first connector

  1. Open the workspace.Create an account or sign in. Start from a template, or choose OpenAPI, Swagger, REST API, GraphQL, gRPC, or SOAP.
  2. Define the upstream API.Upload a contract, import a documentation URL or a collection, or enter operations manually.
  3. Review the tool surface.Expose only the operations an AI client needs and rewrite descriptions to be specific.
  4. Publish and connect.Copy the MCP URL into your client, or use its one-click install link, and complete authorization.
Create a connector

Start from a popular API

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.

Browse templates

Choose the narrowest useful source

Contract

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.

Contract

Swagger

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.

Requests

REST API

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.

Operations

GraphQL

Upload an introspection JSON schema to generate candidate tools from root fields, or define approved queries and mutations manually for tighter control.

Services

gRPC

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.

Services

SOAP

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.

Descriptions are part of the safety boundary

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.

Better description
Cancel an unpaid invoice. This action cannot be undone. Requires invoice ID.
  • Expose only operations required by the intended workflow.
  • Describe required identifiers and important constraints.
  • Call out writes, deletions, notifications, and financial actions.
  • Require the user’s approval for tools that change data.
  • Keep only the response fields agents need, and cap long lists.
  • Test tools with non-production data before wider access.

Serve several APIs from one endpoint

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:

Toolkit MCP URL
https://alltomcp.com/mcp/kit/your-toolkit-slug

Two separate trust boundaries

Client → MCP

OAuth or static token

Controls who may discover and invoke tools on a server or toolkit.

MCP → API

Upstream credential

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.

ChatGPT, Claude, and developer tools

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.

Remote MCP URL
https://alltomcp.com/mcp/your-connector-slug

Developer and automation access

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.

mcp.config.json
{
  "mcpServers": {
    "my-api": {
      "type": "http",
      "url": "https://alltomcp.com/mcp/connector-slug",
      "headers": {
        "X-MCP-Token": "s2m_TOKEN"
      }
    }
  }
}

Work in a team workspace

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.

Role

Viewer

Sees servers, toolkits, and activity, and sets their own credential. Clients they connect get only read-only tools.

Role

Editor

Also creates and changes servers and toolkits: tools, descriptions, tests, and contract syncs.

Role

Admin

Also manages access tokens, environments, OAuth apps, members and invites, and billing, and deletes servers and toolkits.

Role

Owner

An admin who can’t be removed, and the only one who can delete the workspace.

Automate with 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.

List your servers
curl https://alltomcp.com/api/connectors \
  -H "Authorization: Bearer $ALLTOMCP_API_KEY" \
  -H "X-AlltoMCP-Workspace: <team workspace id>"

What each plan allows

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.

Compare plans

Common connection failures

A tool call says a limit is used up
Either the workspace reached its plan’s tool calls for the month, or the server’s own daily quota. The message says which. Plan limits reset on the first of the month (UTC); a server’s quota is in its settings.
Tool call returns HTTP 400
Open the server’s Activity tab in the workspace to inspect the method, status, latency, and error. Verify the upstream base URL, credential, required inputs, and selected operation.
A toolkit doesn’t list a tool
The tool’s server may have stopped publishing it, or it may only accept calls from other networks. The toolkit’s Tools tab flags tools that can’t be served.
Invalid Host
When self-hosting, add the production hostname to ALLOWED_HOSTS, set PUBLIC_BASE_URL to the same HTTPS origin, then redeploy.
Unable to authenticate encrypted data
When self-hosting, ensure every deployment uses the same CREDENTIAL_ENCRYPTION_KEY. Then save the upstream credential again so it is encrypted with the active key.
Connector disappeared after deployment
When self-hosting on Vercel, storage is ephemeral. Configure Supabase and run supabase/schema.sql before relying on durable records.