Overview

Agent3 Hub is a registry for AI resources — agents, MCP servers, APIs, and tools. It exposes everything through a single MCP endpoint so any AI client can discover and invoke resources without knowing where they live.

Quick Start

1. 1. Get an API key

   Sign up at /auth/signup or use the test token on the Register page.

2. 2. Make your first call — search resources

   POST /api/mcpCopy

   curl -X POST https://hub.agent3.me/api/mcp \
     -H "Authorization: Bearer a2a_your_key" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0", "id": 1,
       "method": "tools/call",
       "params": {
         "name": "resources_search",
         "arguments": { "query": "telegram search", "limit": 5 }
       }
     }'

3. 3. Invoke a resource

   resources_invokeCopy

   curl -X POST https://hub.agent3.me/api/mcp \
     -H "Authorization: Bearer a2a_your_key" \
     -H "Content-Type: application/json" \
     -d '{
       "jsonrpc": "2.0", "id": 2,
       "method": "tools/call",
       "params": {
         "name": "resources_invoke",
         "arguments": {
           "resourceId": "a23cc5a9-0bfb-4466-acbe-fbc9af723ba4",
           "operationId": "search-content",
           "input": { "query": "AI news" }
         }
       }
     }'

MCP Integration

Agent3 Hub implements the Model Context Protocol (2025-03-26). Connect any MCP-compatible client — Claude Desktop, Cursor, Cline, OpenClaw — by pointing it at the endpoint.

// claude_desktop_config.json  (or any MCP client)
{
  "mcpServers": {
    "agent3": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://hub.agent3.me/api/mcp"],
      "env": { "AGENT3_API_KEY": "a2a_your_key" }
    }
  }
}

// Public methods (no auth needed)
initialize       — server info
tools/list       — list all 14 tools
resources/list   — list all resources

// Authenticated methods
tools/call       — invoke any tool

HTTP API

All calls are JSON-RPC 2.0 POST https://hub.agent3.me/api/mcp. Pass your key as Authorization: Bearer a2a_....

curl -X POST https://hub.agent3.me/api/mcp \
  -H "Authorization: Bearer a2a_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 1,
    "method": "tools/call",
    "params": {
      "name": "resources_search",
      "arguments": { "query": "telegram search", "limit": 5 }
    }
  }'

curl -X POST https://hub.agent3.me/api/mcp \
  -H "Authorization: Bearer a2a_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0", "id": 2,
    "method": "tools/call",
    "params": {
      "name": "resources_invoke",
      "arguments": {
        "resourceId": "a23cc5a9-0bfb-4466-acbe-fbc9af723ba4",
        "operationId": "search-content",
        "input": { "query": "AI news" }
      }
    }
  }'

Register a Resource

One endpoint for all resource types. Set resourceType to agent, api, sdk, or data.

curl -X POST https://hub.agent3.me/api/resources \
  -H "Authorization: Bearer a2a_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My Agent",
    "description": "What it does",
    "resourceType": "agent",
    "interfaces": [{ "type": "agent", "protocol": "https", "url": "https://..." }],
    "operations": [{
      "id": "run", "name": "Run",
      "description": "Main operation",
      "inputSchema": { "type": "object", "properties": { "input": { "type": "string" } } },
      "bindings": { "a2a": { "skillName": "run" } }
    }],
    "visibility": "public"
  }'

See the full guide with MCP server and API examples → /register

Rate Limits

Rate limit errors return HTTP 429 with remaining and reset_at fields.