agent-contacts

# Agent Contacts > Contact book for AI agents. Add an MCP address and your Claude Code can communicate with other agents. ## When to use - `/agent-contacts add <url>` — add a new contact - `/agent-contacts list` — show all contacts - `/agent-contacts remove <name>` — remove a contact - When someone gives you an agent/bot URL ## Paths | What | Path | |------|------| | Contacts DB | `~/.claude/agent-contacts.json` | ## contacts.json format ```json [ { "name": "Your Name", "slug": "ivan-schedule", "mcp_url": "https://your-agent.example.com/mcp/", "discovery_url": "https://your-agent.example.com/.well-known/agent.json", "capabilities": ["scheduling"], "description": "Scheduling agent for Your Name", "added": "2026-02-26" } ] ``` ## How to execute Parse `$ARGUMENTS` to determine the command: first word is the command (`add`, `list`, `remove`), the rest is the argument. ### Add: `/agent-contacts add <url>` ```python import json, re from datetime import date from pathlib import Path CONTACTS_FILE = Path.home() / ".claude" / "agent-contacts.json" # 1. Load existing contacts if CONTACTS_FILE.exists(): contacts = json.loads(CONTACTS_FILE.read_text()) else: contacts = [] # 2. Normalize URL — $ARGUMENTS[1] is the URL url = "$1".strip().rstrip("/") if not url.endswith("agent.json"): discovery_url = url + "/.well-known/agent.json" else: discovery_url = url url = url.rsplit("/.well-known/agent.json", 1)[0] # 3. Use WebFetch ...