MCP Integration

Postgram exposes machine-agent tooling through MCP over SSE.

What this page covers

MCP setup, tool surface, and output behavior for agent workflows.

Core workflow

1. Point MCP clients at:

http://127.0.0.1:3100/mcp

2. Set auth headers (Bearer API key).

3. Use exposed tools for entity and task operations. Core tool names:

• store, recall, search, update, delete
• task_create, task_list, task_update, task_complete
• sync_push, sync_status
• link, unlink, expand

4. Use compacting for long-running/large responses:

{
  "full_response": true
}

for full REST payloads, and

{
  "toon": true
}

on list-like tools for compact text output.

Notes

• MCP transport is intentionally aligned with the REST model; it does not change your persistence model or auth boundaries.
• Tool output defaults can be compact; the underlying API remains JSON.