Get | Phonic

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

{
  "mcp_server": {
    "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 an MCP server by name or ID.

Authentication

AuthorizationBearer

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

Path parameters

nameOrIdstringRequired

The name or the ID of the MCP server to get.

Query parameters

projectstringOptionalDefaults to main

The name of the project containing the MCP server. Only used when nameOrId is a name.

Response

Success response

mcp_serverobject

A customer-hosted MCP server whose tools can be made available to agents.

Errors

403

Forbidden Error

404

Not Found Error

500

Internal Server Error