# Agentaddress

> Agentaddress is a free MCP server for developer tools. Remote MCP server giving short-lived agents a callback URL, email address and event queue. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** API, CLI, Web
- **Website:** https://agentaddress.dev
- **Repository:** https://github.com/zkarimi22/agentaddress-agents
- **MCP Registry name:** io.github.zkarimi22/agentaddress
- **Categories:** developer tools, communication
- **Listing updated:** 2026-11-16

## About

An AgentAddress is a task-scoped resource that outlives the agent run that made it. It bundles a write-only HTTPS inbox for webhooks, an inbound email address, a private ordered queue of everything received, and a read token a later run uses to fetch and acknowledge events. No account or API key is needed to create one.

A typical flow saves the token and events URL, hands the callback URL or email to the responder, exits, and polls the queue later with a long-poll wait. Small JSON values can also be saved behind the same token so context carries between runs. The README labels every returned email and webhook body as untrusted data.

Free limits are 1,000 retained events per address kept for 30 days, 32 JSON keys of 64 KB total, and up to 20 outbound emails a day. A $17 monthly tier is planned but not available.

## Features

- **Callback URL:** A public write-only HTTPS inbox that receives webhooks without your own server.
- **Inbound email:** An address where people or services can reply after the run ends.
- **Ordered event queue:** HTTP and email events share one private, sequenced feed with acknowledgements.
- **Task context storage:** Stores small JSON values behind the same read token.
- **Skill and CLI helper:** Installable helper keeps the read token in owner-only storage outside model context.
- **Human inbox viewer:** A person with the token can inspect the same events.

## Good for

- Give an API a webhook URL when you have no public server
- Wait for a human email reply after an agent run exits
- Collect a deployment or code review webhook for a later run
- Handle browser verification or approval emails

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http agentaddress https://agentaddress.dev/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://agentaddress.dev/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "agentaddress": {
      "url": "https://agentaddress.dev/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "agentaddress": {
      "type": "http",
      "url": "https://agentaddress.dev/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "agentaddress": {
      "serverUrl": "https://agentaddress.dev/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "agentaddress": {
      "type": "http",
      "url": "https://agentaddress.dev/api/mcp"
    }
  }
}
```

## FAQ

### Does it need an account?

No account or API key is required for provisioning.

### How long are events kept?

Up to 1,000 per address for 30 days.

### Is delivery exactly once?

No. The README says delivery is at least once and acknowledgement records handling.

### What will it cost?

It is free today; a $17 per month tier is planned with allowances still being finalized.

### Is Agentaddress free?

Yes. Agentaddress is free to use.

### How do I add Agentaddress to Claude Code?

Run this command in your terminal: claude mcp add --transport http agentaddress https://agentaddress.dev/api/mcp

### What are the best alternatives to Agentaddress?

The closest alternatives to Agentaddress are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/agentaddress
