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.
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file simpleapps_com_augur_mcp-2026.7.1.tar.gz.
File metadata
- Download URL: simpleapps_com_augur_mcp-2026.7.1.tar.gz
- Upload date:
- Size: 102.7 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
be75ad37d114fc8138d34e06fdeea7684340f38e17bd9f7de439e80ac4fd1381
|
|
| MD5 |
bd1f135f8f78444c2d2e991fdbb0efed
|
|
| BLAKE2b-256 |
d5b58a98b6fc980a33f08d9f15fac004ac9c22533cd8406224c4598321cc944d
|
File details
Details for the file simpleapps_com_augur_mcp-2026.7.1-py3-none-any.whl.
File metadata
- Download URL: simpleapps_com_augur_mcp-2026.7.1-py3-none-any.whl
- Upload date:
- Size: 26.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via:
uv/0.11.33 {"installer":{"name":"uv","version":"0.11.33","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}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
6771febfd9d438e474f43a486fbf276593c1309674b795692ee370592d6b4bb7
|
|
| MD5 |
9e99c1dd45357cd5079c5246a963bada
|
|
| BLAKE2b-256 |
2948fe400a9c56b54f582521b4424e8d903a9421b207589497346de409a1b2a5
|
