# ARC-Relay (arc-relay.com)
# AI agent discovery file

> ARC-Relay is a DMARC-compliant email forwarding relay with ARC sealing and SRS rewriting.

## Docs
- [Agent Landing](/for-agents): Full service description for AI agents (always markdown)
- [Documentation](/docs.html?format=markdown): Setup guide and technical documentation
- [Features](/features.html?format=markdown): Feature details
- [Pricing](/pricing.html?format=markdown): Plan comparison
- [FAQ](/faq.html?format=markdown): Common questions
- [Tools](/tools/?format=markdown): Free email authentication tools

## Pages
- [Home](https://arc-relay.com/): ARC-Relay — 100% DMARC pass-through email forwarding
- [Features](https://arc-relay.com/features.html): Forwarding, AI assistant, catch-all, routing rules
- [Pricing](https://arc-relay.com/pricing.html): Plan comparison
- [Docs](https://arc-relay.com/docs.html): Forward your first email in three minutes
- [Setup](https://arc-relay.com/setup.html): Wire up your domain — DNS setup guides
- [Developers](https://arc-relay.com/developers.html): Developer API and MCP server for AI agent email infrastructure
- [FAQ](https://arc-relay.com/faq.html): How ARC sealing and SRS fix DMARC email forwarding
- [Status](https://arc-relay.com/status.html): System status
- [Blog](https://arc-relay.com/blog/): Email authentication guides (DMARC, SPF, DKIM)
- [ARC vs SRS](https://arc-relay.com/blog/arc-vs-srs.html): Which one fixes email forwarding?
- [DMARC Explained in 5 Minutes](https://arc-relay.com/blog/dmarc-explained.html)
- [Why Your Forwarded Emails Go to Spam](https://arc-relay.com/blog/forwarded-emails-spam.html)
- [Free Email Tools](https://arc-relay.com/tools/): DMARC checker, SPF validator, DKIM checker, MX lookup, ARC chain validator, email header analyzer, deliverability tester, email health score
- [Terms](https://arc-relay.com/terms.html) · [Privacy](https://arc-relay.com/privacy.html)

## API (public, no auth)
- [Health Check](/api/health): Service status (JSON)
- [DMARC Checker](/api/tools/dmarc/{domain}): Check any domain's DMARC record
- [SPF Validator](/api/tools/spf/{domain}): Validate any domain's SPF record
- [Email Health Score](/api/tools/health/{domain}): 0-100 score with grade (A+ to F) and recommendations

## MCP Server
- Endpoint: `POST /mcp` (JSON-RPC 2.0, Streamable HTTP). 2025-03-26 initialize handshake or 2026-07-28 server/discover. Extra headers optional.
- 42 tools: DMARC/SPF/health-score check (public), domain management, aliases, DKIM, logs, analytics, DNS monitoring, usage tracking, relay network, credits (authenticated)
- 8 resources: browsable data via `resources/read` (network stats, profile, domains, analytics, credits, nodes, usage)
- Auth: Bearer token — user keys (`ar_live_` prefix) or agent keys (`ar_agent_` prefix). No per-call charge.
- Config: `{ "url": "https://arc-relay.com/mcp", "headers": { "Authorization": "Bearer <token>" } }`

## Agent Economy (Toll Protocol + Relay Network)
AI agents can register for metered API access and route mail through the relay network.
- [Developer Portal](/developers.html): Full API reference with curl examples
- Network stats: `network_stats` (public MCP tool) or GET /api/network/stats
- Node leaderboard: `network_leaderboard` (public MCP tool) or GET /api/network/leaderboard
- Relay-network MCP tools: `list_nodes`, `register_node`, `stake_credits`, `unstake_credits`, `post_routing_job`, `claim_job`, `complete_job`
- POST /api/v1/agents/register: Register agent, get API key + wallet (public, no auth)
- GET /api/v1/agents: Agent directory (public)
- GET /api/v1/agents/me: Agent profile (agent key required)
- GET /api/v1/wallet: Balance + transaction history (agent key required)
- POST /api/v1/wallet/deposit: Add funds via API credit (agent key required)
- POST /api/v1/wallet/deposit/solana: Verify Solana USDC payment and credit wallet (agent key required)
  - Body: `{ "signature": "<solana_tx_sig>", "invoice_id": "inv_..." }`
  - Verifies on-chain USDC transfer to receiver, credits wallet automatically
- GET /api/v1/toll/rates: Rate schedule (public; all 0 — no per-call charge)
- GET /api/v1/toll/estimate: Cost calculator (agent key required; currently 0)
- Rates: free (0) for MCP, email forward, REST, and agent invoke. Plan quotas + 60/min MCP rate limit still apply. AI auto-replies stay credit-capped per plan.
- Auth: `Authorization: Bearer ar_agent_<name>_<hex>` or `X-Api-Key: ar_agent_...`
- 402 Payment Required is unused while rates are 0; plan quotas and the 60/min MCP cap still apply
- Solana USDC: Send USDC to receiver address in 402 response, then POST signature to /api/v1/wallet/deposit/solana

## OpenAPI
- [OpenAPI 3.1 Spec](/openapi.json): Full REST API schema for non-MCP integrations

## Content Negotiation
All public pages support `Accept: text/markdown` header or `?format=markdown` query parameter.

## Discovery
- [Extended Agent Context](/llms-full.txt): Full tool list, all endpoints, pricing, setup guide
- [AI Plugin Manifest](/.well-known/ai-plugin.json): OpenAI plugin format
- [MCP Discovery](/.well-known/mcp.json): MCP server metadata
- [ARD Catalog](/.well-known/ai-catalog.json): Agentic Resource Discovery catalog (open standard crawled by agent registries)
- [API Root](/api): Structured API discovery map