AgentID MCP
AgentID gives your Claude agent a persistent identity with shared memory, activity reporting, and multi-agent mission coordination — all synchronized in real time across every instance of your agent.
Setup
1. Create your agent at agentid.live
Sign up at https://agentid.live, create an Identity, then create an Agent under it. You'll get:
- An agent handle (e.g.
my_agent)
- An MCP secret from the agent's settings page
2. Add the MCP server to Claude Code
In your Claude Code settings, add the AgentID MCP server:
{
"mcpServers": {
"agentid-{your_handle}": {
"type": "http",
"url": "https://agentid.live/api/mcp/{your_handle}",
"headers": {
"Authorization": "Bearer {your_mcp_secret}"
}
}
}
}
Replace {your_handle} and {your_mcp_secret} with the values from your agent's settings page.
3. Follow the session protocol
Once connected, the MCP server provides resources and tools. At the start of every session:
- Call
report_activity(type="task.started", title="Session started", detail="<what the user asked>")
- Read your identity:
agentid://identity/{handle}
- Read your memory:
agentid://memory/{handle}
- Check for missions:
read_mission()
Available MCP Tools
Memory
write_memory(key, value)
Store a persistent fact about the project or user. Use focused, specific keys — never one large blob.
Examples: project_stack, user_timezone, decision_deploy
read_memory(key?)
Read a specific memory key, or all memory if no key given.
search_memory(query)
Semantic search across all memory entries.
Activity Reporting
report_activity(type, title, detail, tokens_used?)
Report what you're doing — shows in the live Agency dashboard. Valid types:
task.started — before beginning a tasktask.progress — at each meaningful step (detail required)task.completed — when done (include tokens_used)task.failed — on error
Detail is required on every call. Say specifically what happened — not "Task completed" but "Rewrote auth middleware, removed session token storage."
Multi-Agent Missions
Use these when multiple agents share the same identity and need to coordinate.
start_mission({ title, goal })
Declare a shared goal. Returns current status of all agents on this identity.
read_mission()
Read the active mission, all agent statuses, and any handoff addressed to you. Returns a YOUR ACTION section if a handoff targets your handle. Call this at session start.
update_status({ current_task, status })
Broadcast your current task to other agents. Status values: working | idle | done.
handoff({ summary, next_steps[], to? })
Pass work to another agent (or to: "any" for open pickup). Records what you completed and what comes next.
Session Protocol (copy into your CLAUDE.md)
SESSION START: Call report_activity (type="task.started"). Read identity and memory resources. Call read_mission() to check for active missions.
EVERY TASK: Call report_activity (task.started) before starting. Call report_activity (task.progress) at each meaningful step. Call report_activity (task.completed OR task.failed) when done.
MEMORY: Call read_memory at session start. Call write_memory whenever you learn a persistent fact.
MISSIONS: If a handoff is addressed to you, act on it immediately.
Resources
