Augur MCP Server
FastMCP server exposing Augur API microservices as 7 generic MCP tools.
Install
uvx simpleapps-com-augur-mcp
Authentication
Credentials are resolved in this order (first match wins):
- Environment variables —
AUGUR_TOKEN+AUGUR_SITE_ID - Explicit file —
AUGUR_CREDS_FILEenv var pointing to a JSON file (supports~) - Project file —
.simpleapps/augur-api.jsonin the current working directory - Global file —
~/.simpleapps/augur-api.json
Steps 3 and 4 are merged — project credentials take precedence when the same site_id appears in both files.
Single-site credentials
{
"siteId": "your-site-id",
"jwt": "your-jwt-token"
}
Multi-site credentials
Configure multiple sites in a single file:
{
"acme-corp": { "jwt": "acme-jwt" },
"other-site": { "jwt": "other-jwt" }
}
The format is auto-detected: a top-level siteId key means single-site,
otherwise each key is the site ID and its value contains the JWT.
Project + global merge
You can keep site-specific credentials in your project and shared credentials globally:
~/.simpleapps/augur-api.json → {"siteId": "shared-site", "jwt": "..."}
./project/.simpleapps/augur-api.json → {"siteId": "project-site", "jwt": "..."}
Both are loaded and merged. If the same siteId exists in both, the project
file wins.
MCP Configuration
Minimal — no env vars needed when using project or global credentials:
{
"mcpServers": {
"augur-api": {
"command": "uvx",
"args": ["simpleapps-com-augur-mcp"]
}
}
}
Override: specific credentials file
{
"mcpServers": {
"augur-api": {
"command": "uvx",
"args": ["simpleapps-com-augur-mcp"],
"env": {
"AUGUR_CREDS_FILE": "~/projects/clients/acme-corp/.simpleapps/augur-api.json"
}
}
}
}
Override: environment variables
{
"mcpServers": {
"augur-api": {
"command": "uvx",
"args": ["simpleapps-com-augur-mcp"],
"env": {
"AUGUR_TOKEN": "your-jwt-token",
"AUGUR_SITE_ID": "your-site-id"
}
}
}
}
Tools
| Tool | Purpose |
|---|---|
augur_sites |
List configured sites |
augur_discover |
List services or endpoints for a service |
augur_list |
List records (GET collection) |
augur_get |
Get single record by ID |
augur_create |
Create record (POST) |
augur_update |
Update record (PUT) |
augur_delete |
Delete record (DELETE) |
Site parameter
When multiple sites are configured, the 5 data tools (augur_list, augur_get,
augur_create, augur_update, augur_delete) accept an optional site
parameter to specify which site to query. If only one site is configured,
the site parameter can be omitted.
augur_sites
Use augur_sites to see which sites are configured. When only one site exists,
it is marked with "default": true.
Release files for simpleapps-com-augur-mcp 2026.8.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| simpleapps_com_augur_mcp-2026.8.1.tar.gz | 104.0 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| simpleapps_com_augur_mcp-2026.8.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 130.7 kB
Release files / simpleapps_com_augur_mcp-2026.8.1.tar.gz
| Download URL | simpleapps_com_augur_mcp-2026.8.1.tar.gz |
|---|---|
| Size | 104.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
fefcc697616f583006b4cbe4020fabff7eb9833ab721132737eda80db8f0ed0e
|
|
BLAKE2b-256 checksum How to use checksums |
0ffe3a684fadaafd4a925693f9c7aac470d1677d4b7401ce7019ba336c0a1f76
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
Release files / simpleapps_com_augur_mcp-2026.8.1-py3-none-any.whl
| Download URL | simpleapps_com_augur_mcp-2026.8.1-py3-none-any.whl |
|---|---|
| Size | 26.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
84fee87f4d809c96a401dfeafda2c8212260900f084aa4762c4d8835238ed4d5
|
|
BLAKE2b-256 checksum How to use checksums |
be102fa29e690902c9e6cd71704cfd097f343ed1ec8b6dd9bda57d86aad9790a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.7 {"installer":{"name":"uv","version":"0.12.7","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
|
