MCP Server API Reference

Complete API reference for MCP Servers.

Base URL: https://api.universalapi.co

Create Server

POST /mcp-admin/create

curl -s -X POST https://api.universalapi.co/mcp-admin/create \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "serverName": "my-server",
    "description": "A useful MCP server",
    "sourceCode": "...",
    "visibility": "public"
  }' | jq

Parameter	Type	Required	Description
serverName	string	Yes	Lowercase with hyphens
description	string	Yes	What the server does
sourceCode	string	Yes	Node.js code with createMcpServer()
visibility	string	No	"private" (default) or "public"

List Servers

GET /mcp-admin/list

curl -s https://api.universalapi.co/mcp-admin/list \
  -H "Authorization: Bearer YOUR_TOKEN" | jq

Optional query parameters: visibility (all, public, private), limit

Get Server

GET /mcp-admin/{serverId}
GET /mcp-admin/s/{owner}/{slug}

# By ID
curl -s https://api.universalapi.co/mcp-admin/mcp-xxx | jq

# By slug
curl -s https://api.universalapi.co/mcp-admin/s/snowtimber/serpapi | jq

Update Server

PUT /mcp-admin/update

curl -s -X PUT https://api.universalapi.co/mcp-admin/update \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "serverId": "mcp-xxx",
    "description": "Updated description",
    "sourceCode": "..."
  }' | jq

Delete Server

DELETE /mcp-admin/delete

curl -s -X DELETE https://api.universalapi.co/mcp-admin/delete \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"serverId": "mcp-xxx"}' | jq

MCP Protocol Endpoint

POST /mcp/{serverId}
POST /mcp/s/{owner}/{slug}
GET  /mcp/{serverId}
GET  /mcp/s/{owner}/{slug}

This is the endpoint AI clients (Claude, Cline) connect to. It speaks the MCP protocol:

# List available tools
curl -s -X POST https://mcp.api.universalapi.co/mcp/mcp-xxx \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"method": "tools/list", "params": {}}' | jq

# Call a tool
curl -s -X POST https://mcp.api.universalapi.co/mcp/mcp-xxx \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{
    "method": "tools/call",
    "params": {
      "name": "google_search",
      "arguments": {"query": "Universal API"}
    }
  }' | jq

# List resources
curl -s -X POST https://mcp.api.universalapi.co/mcp/mcp-xxx \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"method": "resources/list", "params": {}}' | jq