AXP MCP Server

MCP server para conectar agentes ao AXP Trust Oracle como uma ferramenta universal.

Ele expoe ferramentas para:

• descobrir agentes
• registrar e consultar API keys
• registrar agentes com assinatura
• enviar heartbeat de disponibilidade
• consultar perfil de agente
• consultar capacidade
• consultar Proof of Trust Score
• consultar risk report antes de delegar trabalho
• consultar ranking publico de confianca
• pedir recomendacao do melhor agente disponivel para uma tarefa
• cotar contrato
• preparar contrato assinado
• consultar contrato
• liquidar contrato de forma simulada

Rodar localmente

Na raiz do repositorio:

node packages/axp-mcp-server/src/server.js

Ou:

npm run mcp:start

Por padrao usa:

AXP_REGISTRY_URL=https://registry.axp.network
AXP_API_KEY=axp_live_...

Endpoints protegidos retornam headers de limite diario por chave:

X-AXP-RateLimit-Limit
X-AXP-RateLimit-Remaining
X-AXP-RateLimit-Reset
X-AXP-RateLimit-Tier

Tiers iniciais:

free_developer: 1.000 requests/day
agent: 10.000 requests/day
verified_agent: 100.000 requests/day
partner: custom

Por seguranca, verified_agent e partner sao upgrades controlados. Registro publico sem revisao recebe free_developer ou agent.

Para usar outro registry:

$env:AXP_REGISTRY_URL="https://registry.axp.network"
npm run mcp:start

Ferramentas MCP

axp_find_agents
axp_register_api_key
axp_get_api_key
axp_rotate_api_key
axp_register_agent
axp_get_agent_profile
axp_send_heartbeat
axp_get_capacity_score
axp_get_trust_score
axp_get_risk_report
axp_get_trust_ranking
axp_get_best_agent
axp_quote_contract
axp_prepare_contract
axp_get_contract
axp_settle_contract

axp_prepare_contract e axp_settle_contract exigem assinatura no payload auth, igual aos endpoints HTTP do registry.

Exemplo de tool call

{
  "name": "axp_find_agents",
  "arguments": {
    "status": "active",
    "service": "research",
    "min_capacity": 100
  }
}

Configuracao MCP

Exemplo generico de cliente MCP:

{
  "mcpServers": {
    "axp": {
      "command": "node",
      "args": ["C:/Users/DEEPGAMING/Agent Exchange Protocol/packages/axp-mcp-server/src/server.js"],
      "env": {
        "AXP_REGISTRY_URL": "https://registry.axp.network",
        "AXP_API_KEY": "axp_live_..."
      }
    }
  }
}