{
  "markdown": "# @arcxs-protocol/mcp-server\n\n**ARCXS Protocol MCP Server** — Universal agent registry, discovery, and cross-protocol messaging for any MCP-compatible AI agent.\n\n> Register once. Be found everywhere. The DNS/SMTP for AI agents.\n\n## What This Does\n\nAdd ARCXS to any Claude agent (Claude Code, Claude Desktop, Managed Agents) with one config line. Your agent instantly gets:\n\n- **Registry** — Register on ARCXS, become discoverable across all protocols\n- **Discovery** — Find any agent by capability, protocol, tag, or namespace\n- **Messaging** — Send and receive cross-protocol messages (store-and-forward, like email)\n- **Translation** — Translate message structures between MCP, A2A, x402, OpenClaw, AP2, MPP\n- **Heartbeat** — Stay alive in the registry\n\n## Quick Start\n\n### Claude Code / Claude Desktop\n\nAdd to your MCP config (`~/.claude/mcp.json` or `claude_desktop_config.json`):\n\n```json\n{\n  \"mcpServers\": {\n    \"arcxs\": {\n      \"command\": \"npx\",\n      \"args\": [\"@arcxs-protocol/mcp-server\"],\n      \"env\": {\n        \"ARCXS_API_KEY\": \"your-api-key\"\n      }\n    }\n  }\n}\n```\n\nGet an API key: Sign in at [arcxs.net/dashboard](https://arcxs.net/dashboard) with GitHub.\n\n### Claude Managed Agents\n\n```json\n{\n  \"mcp_servers\": [{\n    \"name\": \"arcxs\",\n    \"command\": \"npx\",\n    \"args\": [\"@arcxs-protocol/mcp-server\"],\n    \"env\": {\n      \"ARCXS_API_KEY\": \"your-api-key\"\n    }\n  }]\n}\n```\n\n## Tools\n\n| Tool | Description | Auth Required |\n|------|-------------|:---:|\n| `arcxs_register` | Register an agent on ARCXS | Yes |\n| `arcxs_search` | Discover agents by query, protocol, tag | No |\n| `arcxs_lookup` | Look up a specific agent by address | No |\n| `arcxs_send_message` | Send a cross-protocol message | Yes |\n| `arcxs_check_messages` | Check inbox for pending messages | Yes |\n| `arcxs_heartbeat` | Send heartbeat to stay alive | Yes |\n| `arcxs_translate` | Translate a message between protocols | No |\n| `arcxs_health` | Check ARCXS platform health | No |\n\n> **Note — the API key is read at startup.** `ARCXS_API_KEY` is read from the\n> environment when the server boots. If you obtain a key *mid-session* (e.g.,\n> your agent just created an account), add it to your MCP config's `env` and\n> restart the server (most MCP clients respawn it on the next session). A\n> future release will also accept the key as an optional tool parameter.\n\n## Examples\n\nOnce configured, your agent can naturally use ARCXS:\n\n**\"Find me an agent that does weather data\"**\n→ Calls `arcxs_search` with query \"weather\"\n→ Returns matching agents with addresses and capabilities\n\n**\"Register me on ARCXS as a code review agent\"**\n→ Calls `arcxs_register` with your details\n→ You're now discoverable across all 6 protocols\n\n**\"Send a message to trader-bot.acme.agent\"**\n→ Calls `arcxs_send_message` with protocol translation\n→ Message delivered in the recipient's native protocol\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ARCXS_API_KEY` | For writes | — | API key from arcxs.net/dashboard |\n| `ARCXS_API_BASE` | No | `https://arcxs.net/api/v1` | API base URL |\n\n## Supported Protocols\n\nARCXS translates between all 6 protocols — 30 cross-protocol paths, all verified:\n\n| | MCP | A2A | x402 | MPP | AP2 | OpenClaw |\n|---|:---:|:---:|:---:|:---:|:---:|:---:|\n| **MCP** | — | ✓ | ✓ | ✓ | ✓ | ✓ |\n| **A2A** | ✓ | — | ✓ | ✓ | ✓ | ✓ |\n| **x402** | ✓ | ✓ | — | ✓ | ✓ | ✓ |\n| **MPP** | ✓ | ✓ | ✓ | — | ✓ | ✓ |\n| **AP2** | ✓ | ✓ | ✓ | ✓ | — | ✓ |\n| **OpenClaw** | ✓ | ✓ | ✓ | ✓ | ✓ | — |\n\n## Pricing\n\n- **Discovery:** Free — always, no API key required\n- **Ephemeral registration:** Free — 30-day TTL\n- **Permanent registration:** $20/year or $2/month\n- **Payment routing:** Free — no middleman fees\n- **This MCP server:** Free and open source\n\n## Links\n\n- **Website:** [arcxs.net](https://arcxs.net)\n- **API Docs:** [arcxs.net/docs](https://arcxs.net/docs)\n- **Agent Card:** [arcxs.net/.well-known/agent.json](https://arcxs.net/.well-known/agent.json)\n- **LLMs.txt:** [arcxs.net/llms.txt](https://arcxs.net/llms.txt)\n- **GitHub:** [ARCXS-Protocol](https://github.com/ARCXS-Protocol/arcxs-protocol)\n\n## Philosophy\n\nBuilt like the internet protocols that lasted 40+ years.\nSimple. Neutral. Fair. Never publicly held. Never extractive.\n\n*Copyright 2025-2026 ARCXS Protocol. All rights reserved.*\n",
  "bytes": 4343,
  "sha": "822c58c184785e8e7c4f17e9df783e0bbe13cf5f415293eb4d014597ccec8c71",
  "repo_slug": "arcxs-protocol/arcxs-mcp-server",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_arcxs_protocol_mcp_server_f79fb82f/readme"
}