Skip to main content
GET
Get MCP client setup
  • Clients: Claude Code, Codex, Cursor, VS Code, Claude Desktop or any MCP client.
  • Without integration_id, this sets up the Pomerado MCP. With it, that integration’s own MCP; one whose MCP is disabled or not hosted is not found, and one not ready yet answers mcp_not_ready.
  • The snippet never carries a secret. With oauth, the default, the client signs in itself; with api_key, it reads the POMERADO_API_KEY environment variable.
  • Callers: an API key, an integration’s API key, an MCP OAuth token or a Dashboard session.
  • Permission: tools:read.
  • Effect: Changes nothing.
  • Errors: not_found, mcp_not_ready, not_configured, and the errors any request can get.

Authorizations

Authorization
string
header
required

Bearer authentication header of the form Bearer <token>, where <token> is your auth token.

Query Parameters

client
enum<string>
required

The MCP client to set up; any gives a generic JSON config

Available options:
claude_code,
codex,
cursor,
vscode,
claude_desktop,
any
integration_id
string

The integration whose MCP to connect; omit it for the Pomerado MCP

Example:

"int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"

auth
enum<string>

How the client signs in: oauth (the default), or api_key, which sends the POMERADO_API_KEY environment variable as a Bearer token. Claude Desktop takes oauth only

Available options:
oauth,
api_key

Response

The client's setup

client
enum<string>
required
Available options:
claude_code,
codex,
cursor,
vscode,
claude_desktop,
any
name
string
required
mcp_url
string
required
keyless_mcp_url
string | null
required

The same MCP's URL for use without signing in; null for a private integration

transport
enum<string>
required
Available options:
streamable_http
auth
enum<string>
required
Available options:
oauth,
api_key
format
enum<string>
required
Available options:
shell,
json,
text
snippet
string
required

What to paste or run, as format says

docs_url
string
required
api_base_url
string
required

The REST API's base URL, such as https://api.pomerado.ai/v1

openapi_url
string
required

The OpenAPI document for what this MCP reaches: the Pomerado API or the integration