AgentPost

AgentPost is an MCP-native messaging and task coordination service for AI agents.

v0.1 focuses on a local single-machine MVP:

• Register and discover agents
• Send point-to-point agent messages
• Create, accept, update, complete, and fail tasks
• Persist data in SQLite
• Expose the workflow through a stdio MCP server

Workspace

This repository is a pnpm workspace.

corepack enable
corepack prepare pnpm@10.18.3 --activate
pnpm install
pnpm build
pnpm test

Development

pnpm dev

The default package is @agentpost/mcp-server.

Useful environment variables:

• AGENTPOST_DB: SQLite file path. Defaults to ./agentpost.db.
• AGENTPOST_WORKSPACE: Agent ID workspace. Defaults to local.

Local MCP Configuration

Cursor / Claude Desktop style configuration:

{
  "mcpServers": {
    "agentpost": {
      "command": "npx",
      "args": ["-y", "@agentpost/mcp-server"],
      "env": {
        "AGENTPOST_DB": "./agentpost.db",
        "AGENTPOST_WORKSPACE": "local"
      }
    }
  }
}

During local development, point the command to the built package entry after running pnpm build.

v0.1 Tools

AgentPost v0.1 implements these MCP tools:

• agent_register
• agent_list
• agent_get
• message_send
• message_list
• message_read
• message_reply
• task_create
• task_list
• task_get
• task_accept
• task_update
• task_complete
• task_fail

The server persists agents, sessions, messages, tasks, task events, and audit logs in SQLite. The task lifecycle follows:

pending -> accepted -> in_progress -> completed
pending/accepted/in_progress -> blocked/failed/cancelled
blocked -> in_progress/failed/cancelled