List

GET

https://api.phonic.ai/v1/mcp_servers

GET

/v1/mcp_servers

import requests
url = "https://api.phonic.ai/v1/mcp_servers"
querystring = {"project":"main"}
headers = {"Authorization": "Bearer <apiKey>"}
response = requests.get(url, headers=headers, params=querystring)
print(response.json())

{
  "mcp_servers": [
    {
      "id": "mcp_server_3f8b2c1d-6a4e-4b7f-9c2d-1e5a7b9c0d2f",
      "project": {
        "id": "proj_ad0334f1-2487-4155-9df3-abd8129b29ad",
        "name": "main"
      },
      "name": "crm_server",
      "url": "https://mcp.example.com/mcp",
      "header_names": [
        "Authorization"
      ],
      "tools": [
        {
          "name": "lookup_customer",
          "description": "Looks up a customer by phone number.",
          "parameters": {
            "type": "object",
            "properties": {
              "phone_number": {
                "type": "string",
                "description": "The customer's phone number."
              }
            },
            "required": [
              "phone_number"
            ],
            "additionalProperties": false
          }
        }
      ]
    }
  ]
}

Returns all MCP servers in a project.

Authentication

AuthorizationBearer

Bearer authentication header of the form Bearer <PHONIC_API_KEY>. Manage your API keys here.

Query parameters

projectstringOptionalDefaults to main

The name of the project to list MCP servers for.

Response

Success response

mcp_serverslist of objects

Errors

404

Not Found Error

500

Internal Server Error