MCP · Docs

MCP quickstart

Connect an MCP client to Paseo at /mcp. It offers two tools: a list of our agents, and text generation on a hosted open model. You need an API key. MCP is not billed. Our agents are available by arrangement.

The /mcp endpoint

post/mcp

Paseo runs a Model Context Protocol server at /mcp on https://api.augmentev.ai. It uses streamable HTTP. Any MCP client that supports streamable HTTP can start a session, list the tools and call them. The server names itself as:

FieldValue
server_info.namepaseo-gateway-mcp
server_info.titlePASEO Gateway MCP
capabilitiestools

Authentication

Every /mcp request needs a valid API key or an operator JWT. A request without one gets 401. Put the credential in the standard header:

http header
Send the credential on every request, including initialize. Self-serve signup is paused. To get an API key, contact us.

Connect a client

Point any streamable-HTTP MCP client at the endpoint. A bare initialize call over HTTP looks like this:

curl · initialize

Most people won't write JSON-RPC by hand. Point your MCP client library at the URL and give it your credential. With a TypeScript MCP SDK, it looks roughly like this:

javascript · mcp client (illustrative)
This is an example only. Class names differ between SDKs. What matters is the endpoint URL, the streamable-HTTP transport, the bearer header and the tool names. Those match our gateway.

Tools

Each tool has a JSON Schema for its input and output. Each also has at least two examples in its MCP _meta.examples field. That lets a Code Mode client find and use the tools by itself. Live today:

ToolDoes
paseo.agent.listLists our agents.
paseo.inference.generateGenerates text from one prompt, on a hosted open model.
These two tools are the only ones offered today. MCP calls get no signed record. The Confidential tier is not offered, so tier: confidential is refused.

Calling a tool — paseo.agent.list

curl · tools/call

Idempotency & spend

You can safely retry a call. Send the same Idempotency-Key again and you get the saved answer back. MCP calls are not billed.

Discovery

A client can find /mcp without a credential. Two public files list the MCP URL:

  • The agent card at /.well-known/agent.json. The MCP URL is under interfaces.mcp.
  • An OpenAI-style plugin manifest at GET /.well-known/openai. The MCP URL is in the apis[] array, in the entry with "type": "mcp". It supports ETag and If-None-Match.