Connect with MCP

curl --fail-with-body --silent --show-error --max-time 15 \
  'https://agentranking.io/mcp' \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2026-07-28' \
  -H 'Mcp-Method: server/discover' \
  --data '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "server/discover",
    "params": {
      "_meta": {
        "io.modelcontextprotocol/protocolVersion": "2026-07-28",
        "io.modelcontextprotocol/clientInfo": {"name": "my-app", "version": "1.0.0"},
        "io.modelcontextprotocol/clientCapabilities": {}
      }
    }
  }'

const endpoint = 'https://agentranking.io/mcp';
const version = '2026-07-28';
let nextId = 0;

async function readJson(url, options = {}) {
  const response = await fetch(url, {
    ...options,
    signal: AbortSignal.timeout(15000),
  });
  const body = await response.json().catch(() => null);
  if (!response.ok) {
    const detail = body?.error?.message ?? body?.detail ?? 'Request failed';
    throw new Error(`HTTP ${response.status}: ${detail}`);
  }
  if (body === null) throw new Error('Expected a JSON response');
  return body;
}

const discovery = await readJson('https://agentranking.io/.well-known/mcp.json');
if (discovery.protocolVersion !== version || discovery.transport?.url !== endpoint) {
  throw new Error('Connection details changed; review the MCP discovery document');
}

async function rpc(method, params = {}) {
  const id = ++nextId;
  const body = await readJson(endpoint, {
    method: 'POST',
    headers: {
      'Content-Type': 'application/json',
      Accept: 'application/json, text/event-stream',
      'MCP-Protocol-Version': version,
      'Mcp-Method': method,
      ...(method === 'tools/call' ? { 'Mcp-Name': params.name } : {}),
    },
    body: JSON.stringify({
      jsonrpc: '2.0', id, method,
      params: {
        ...params,
        _meta: {
          'io.modelcontextprotocol/protocolVersion': version,
          'io.modelcontextprotocol/clientInfo': { name: 'my-app', version: '1.0.0' },
          'io.modelcontextprotocol/clientCapabilities': {},
        },
      },
    }),
  });
  if (body.jsonrpc !== '2.0' || body.id !== id) throw new Error('Unexpected MCP response');
  if (body.error) throw new Error(`MCP ${body.error.code}: ${body.error.message}`);
  if (!body.result) throw new Error('Missing MCP result');
  return body.result;
}

async function callTool(name, args) {
  const result = await rpc('tools/call', { name, arguments: args });
  const text = result.content?.find(item => item.type === 'text')?.text;
  if (result.isError) throw new Error(text ?? 'Tool call failed');
  if (result.structuredContent !== undefined) return result.structuredContent;
  if (typeof text !== 'string') throw new Error('Missing tool output');
  return JSON.parse(text);
}

const server = await rpc('server/discover');
if (!server.supportedVersions?.includes(version)) throw new Error('Unsupported MCP revision');
const catalog = await rpc('tools/list');
for (const name of ['search_agents', 'get_agent']) {
  if (!catalog.tools?.some(tool => tool.name === name)) throw new Error(`Tool unavailable: ${name}`);
}

const results = await callTool('search_agents', { query: 'research', limit: 5 });
for (const agent of results.agents) console.log(agent.publicId, agent.name);
if (results.agents.length > 0) {
  const profile = await callTool('get_agent', { entityPublicId: results.agents[0].publicId });
  console.log(profile);
} else {
  console.log('No matches. Try another query or omit the query filter.');
}