Augur

MCP Server

Model Context Protocol server for AI agent integration with Augur.

MCP Server

The Augur MCP Server exposes all Augur microservices through 7 generic tools via the Model Context Protocol. Any MCP-compatible AI agent can use it.

Installation

pip install simpleapps-com-augur-mcp

Tools

ToolPurpose
augur_discoverList services or endpoints for a service
augur_sitesList configured sites with default flag
augur_listList records (GET collection)
augur_getGet single record by ID
augur_createCreate record (POST)
augur_updateUpdate record (PUT)
augur_deleteDelete record (DELETE)

All data tools accept an optional site parameter for multi-site deployments.

Usage Pattern

Always start with discovery:

1. augur_sites()          → see configured sites
2. augur_discover()       → list all services
3. augur_discover(service="items")  → list endpoints
4. augur_list(service="items", endpoint="/inv-mast", params={"limit": 10})

Do not hardcode service names or endpoints. Use augur_discover to find them at runtime.

Authentication

Credentials resolve automatically from .simpleapps/ directories. See API Overview for the full resolution order and multi-site format.

All data tools accept an optional site parameter for multi-site deployments:

augur_list(service="items", endpoint="/inv-mast", site="client-a")