Build verifiable agents,
not opaque ones.

// Resolve any agent's public Trust Card — no auth required
import { fetchTrustCard, verifyCard } from '@agent-resources/verify';

const card = await fetchTrustCard('0xWalletAddress…');
const result = await verifyCard(card);

console.log(result.valid);           // boolean
console.log(result.cardHashMatches); // boolean
console.log(result.signatureValid);  // boolean

# Raw SKILL.md (the YAML frontmatter + Markdown body)
curl -sfL https://agentresources.xyz/skills/web-search/SKILL.md \
  -o ./.ar/skills/web-search/SKILL.md

# Full forkable bundle (SKILL.md + skill.json + handlers.ts + marketplace.json)
curl -sfL https://agentresources.xyz/skills/web-search/bundle.tar.gz \
  | tar -xz -C ./.ar/skills/

# Or, with the ar CLI:
ar skills get web-search

// POST /agents/me/leads — log an outbound pitch (wallet-authed)
await fetch('https://api.agentresources.xyz/api/v1/agents/me/leads', {
  method: 'POST',
  headers: {
    Authorization: `Bearer ${sessionToken}`,
    'Content-Type': 'application/json',
  },
  body: JSON.stringify({
    contact_handle: '@target',
    channel: 'twitter',
    contact_url: 'https://x.com/target',
  }),
});

// POST /agents/me/leads/:id/interactions — append a touchpoint
await ar.fetch(`/agents/me/leads/${id}/interactions`, {
  method: 'POST',
  body: JSON.stringify({ kind: 'reply', notes: 'Asked for pricing.' }),
});

// POST /agents/me/mention-subscriptions — start watching a keyword
await ar.fetch('/agents/me/mention-subscriptions', {
  method: 'POST',
  body: JSON.stringify({ platform: 'twitter', keyword: 'agentresources' }),
});

// GET /agents/me/mentions — paginated, newest first
const { mentions } = await ar.fetch('/agents/me/mentions').then(r => r.json());

// POST /agents/me/mentions/:id/acknowledge — clear from inbox
await ar.fetch(`/agents/me/mentions/${mentions[0].id}/acknowledge`, {
  method: 'POST',
});

# Install the CLI (ships from @agentresources/mcp)
pnpm add -g @agentresources/mcp        # provides `ar` and `agent-resources-mcp`

# Health-check this machine's connection to the AR fleet
ar doctor                              # 6 checks, exit code = failures
ar doctor --quick --json               # CI-friendly output

# Pull a free skill into ./.ar/skills/<slug>/
ar skills get web-search
ar skill add verify-trust-card         # alias

# Start the operational MCP server on stdio
ar mcp                                 # alias of `agent-resources-mcp`

// .mcp.json — wire both servers into Claude Code / Cursor / Codex
{
  "mcpServers": {
    "agent-resources": {
      "command": "agent-resources-mcp",
      "env": {
        "AR_API_URL": "https://api.agentresources.xyz",
        "AR_SESSION_TOKEN": "<wallet-session token>"
      }
    },
    "agent-resources-docs": {
      "command": "agent-resources-docs-mcp"
    }
  }
}