← Skills

Open Source · MIT License

Agent Phonebook — contacts for AI bots

Add an MCP address to your Claude Code and it can talk to other people's bots. Book meetings, query data, trigger actions — all through the terminal. Think WhatsApp, but for AI agents.

MIT License GitHub Stars
claude code
> /agent-phonebook add https://ivan-bot.com

Fetching /.well-known/agent.json...
Found: Ivan Pasichnyk
Capabilities: scheduling
Saved to contacts
MCP registered as ivan-pasichnyk

Contact added. Restart session to use their tools.

---

> Book a meeting with Ivan about AI consulting
Using tool: get_available_slots
Using tool: book_consultation
Booked: Wed Mar 05, 14:00 WITA

Why Agent Phonebook?

One command to connect

No APIs to learn, no SDKs to install. Just /agent-phonebook add URL and your AI can use their tools. Standard MCP protocol.

Decentralized by design

No central server, no registry, no middleman. Each agent publishes its own agent.json. You save contacts locally. Direct peer-to-peer.

You control everything

Contacts are a JSON file on your machine. HTTPS-only validation, no data leaves your terminal. Add and remove bots as you wish.

How it works

From URL to working connection in 30 seconds

1
Someone shares their bot URL

They give you their base URL or agent.json discovery link

2
You add it to your phonebook

/agent-phonebook add https://their-bot.com

3
Skill discovers capabilities

Fetches agent.json, extracts name, tools, MCP endpoint. Saves contact and registers MCP server.

4
Use their tools naturally

After restarting session, just talk: "Book a meeting with Ivan" — Claude calls their MCP tools automatically.

~/.claude/agent-contacts.json
[
  {
    "name": "Ivan Pasichnyk",
    "slug": "ivan-schedule",
    "mcp_url": "https://bot.example.com/mcp/",
    "capabilities": ["scheduling"],
    "added": "2026-02-26"
  }
]
Their /.well-known/agent.json
{
  "name": "Ivan Pasichnyk",
  "capabilities": {
    "scheduling": {
      "url": "https://bot.example.com/mcp/",
      "tools": [
        "get_available_slots",
        "book_consultation"
      ]
    }
  }
}

Who is it for?

Claude Code users

You live in the terminal and want your AI to connect to other people's services without leaving the command line.

Bot builders

You deployed an MCP-compatible bot and want others to easily discover and connect to it. Share your URL, they run one command.

Teams & consultants

Your team members each have their own scheduling bots, CRM bots, or data bots. The phonebook lets everyone connect to everyone.

Install in 10 seconds

terminal
# Install the skill
$ git clone https://github.com/anthroos/-agent-phonebook.git \
    ~/.claude/skills/agent-phonebook

# Done. Open a new Claude Code session and use:
> /agent-phonebook add https://some-bot.com
> /agent-phonebook list
> /agent-phonebook remove some-slug

Connect your AI to the world

Install the phonebook, add your first contact, and let your Claude Code talk to other bots. Open source, zero config.