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.9.4
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.9.4.tar.gz | 104.2 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| simpleapps_com_augur_mcp-2026.9.4-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 130.9 kB
Release files / simpleapps_com_augur_mcp-2026.9.4.tar.gz
| Download URL | simpleapps_com_augur_mcp-2026.9.4.tar.gz |
|---|---|
| Size | 104.2 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
023a83991b2dee3bf329da50bd3da54dec23f0b6db185046a3936431ee45248f
|
|
BLAKE2b-256 checksum How to use checksums |
8541a743f14c77f7c142508f450f46e1771d0fa106be12dda0877b01f551ca4b
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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.9.4-py3-none-any.whl
| Download URL | simpleapps_com_augur_mcp-2026.9.4-py3-none-any.whl |
|---|---|
| Size | 26.7 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
d3373f83edb8d5e23b5241a3762f50ef2e4d0c8b1b58d795970f72e859fa8489
|
|
BLAKE2b-256 checksum How to use checksums |
146b9046e0afda73374a6893404c7e2f071a2afb07b146bf6fb22046f487a0b7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.18 {"installer":{"name":"uv","version":"0.12.18","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}
|
