Skip to main content
GET
https://api.compose.market
/
registry
/
servers
Tool Registry
curl --request GET \
  --url https://api.compose.market/registry/servers
{
  "registryId": "goat:coingecko",
  "origin": "goat",
  "name": "CoinGecko",
  "description": "Cryptocurrency market data and prices",
  "namespace": "goat-sdk",
  "transport": "npx",
  "available": true,
  "executable": true,
  "tools": [
    {
      "name": "get_coin_price",
      "description": "Get current price for a cryptocurrency",
      "inputSchema": {
        "type": "object",
        "properties": {
          "coinId": { "type": "string", "description": "CoinGecko coin ID" },
          "currency": { "type": "string", "default": "usd" }
        },
        "required": ["coinId"]
      }
    },
    {
      "name": "get_coin_market_chart",
      "description": "Get historical price data",
      "inputSchema": {
        "type": "object",
        "properties": {
          "coinId": { "type": "string" },
          "days": { "type": "number" }
        }
      }
    }
  ]
}
The Connector service maintains a unified registry of all available tools from MCP servers, GOAT plugins, and internal services.

​
List All Tools

GET /registry/servers
Returns all tools in the registry.

​
Query Parameters

​
origin
string
Filter by origin: mcp, goat, internal
​
executable
boolean
Filter to only executable tools
​
search
string
Search by name or description

​
Response

{
  "servers": [
    {
      "registryId": "goat:coingecko",
      "origin": "goat",
      "name": "CoinGecko",
      "description": "Cryptocurrency market data and prices",
      "transport": "npx",
      "toolCount": 5,
      "available": true,
      "executable": true
    },
    {
      "registryId": "mcp:github",
      "origin": "mcp",
      "name": "GitHub",
      "description": "GitHub repository operations",
      "transport": "npx",
      "toolCount": 12,
      "available": true,
      "executable": true
    }
  ],
  "total": 500
}

​
Get Server Details

GET /registry/servers/{registryId}
Returns detailed information about a specific server, including all tools.
​
registryId
string
required
Server registry ID (e.g., goat:coingecko)
{
  "registryId": "goat:coingecko",
  "origin": "goat",
  "name": "CoinGecko",
  "description": "Cryptocurrency market data and prices",
  "namespace": "goat-sdk",
  "transport": "npx",
  "available": true,
  "executable": true,
  "tools": [
    {
      "name": "get_coin_price",
      "description": "Get current price for a cryptocurrency",
      "inputSchema": {
        "type": "object",
        "properties": {
          "coinId": { "type": "string", "description": "CoinGecko coin ID" },
          "currency": { "type": "string", "default": "usd" }
        },
        "required": ["coinId"]
      }
    },
    {
      "name": "get_coin_market_chart",
      "description": "Get historical price data",
      "inputSchema": {
        "type": "object",
        "properties": {
          "coinId": { "type": "string" },
          "days": { "type": "number" }
        }
      }
    }
  ]
}

​
Get Spawn Configuration

GET /registry/servers/{registryId}/spawn
Returns the spawn configuration for an MCP server. 
{
  "transport": "npx",
  "package": "@modelcontextprotocol/server-github",
  "env": {
    "GITHUB_TOKEN": "required"
  }
}