curl --request GET \
--url https://api.pomerado.ai/v1/connect \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/connect', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/connect"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"client": "claude_code",
"name": "<string>",
"mcp_url": "<string>",
"keyless_mcp_url": "<string>",
"transport": "streamable_http",
"auth": "oauth",
"format": "shell",
"snippet": "<string>",
"docs_url": "<string>",
"api_base_url": "<string>",
"openapi_url": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Get MCP client setup
Get the setup for adding an MCP to one client: the command or config, ready to paste.
curl --request GET \
--url https://api.pomerado.ai/v1/connect \
--header 'Authorization: Bearer <token>'const options = {method: 'GET', headers: {Authorization: 'Bearer <token>'}};
fetch('https://api.pomerado.ai/v1/connect', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.pomerado.ai/v1/connect"
headers = {"Authorization": "Bearer <token>"}
response = requests.get(url, headers=headers)
print(response.text){
"client": "claude_code",
"name": "<string>",
"mcp_url": "<string>",
"keyless_mcp_url": "<string>",
"transport": "streamable_http",
"auth": "oauth",
"format": "shell",
"snippet": "<string>",
"docs_url": "<string>",
"api_base_url": "<string>",
"openapi_url": "<string>"
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}{
"error": {
"code": "<string>",
"message": "<string>",
"retryable": true,
"docs_url": "<string>",
"details": {}
}
}Details
Details
- 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
Bearer authentication header of the form Bearer <token>, where <token> is your auth token.
Query Parameters
The MCP client to set up; any gives a generic JSON config
claude_code, codex, cursor, vscode, claude_desktop, any The integration whose MCP to connect; omit it for the Pomerado MCP
"int_0f8e2d1c4b3a49e8a7f6e5d4c3b2a190"
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
oauth, api_key Response
The client's setup
claude_code, codex, cursor, vscode, claude_desktop, any The same MCP's URL for use without signing in; null for a private integration
streamable_http oauth, api_key shell, json, text What to paste or run, as format says
The REST API's base URL, such as https://api.pomerado.ai/v1
The OpenAPI document for what this MCP reaches: the Pomerado API or the integration