This project has been archived by its maintainers, and is no longer receiving any updates.
Augur MCP Server
This package is retired. This is its final release, and it gets no further updates. Use the hosted Augur API MCP server instead:
claude mcp add --transport http augur-api https://augur-api.io/mcp \ --header "Authorization: Bearer <your agr-int user JWT>"The hosted server needs no install or credentials file. It reaches every endpoint in the current SDK, and the site comes from your token. Progress: simpleapps-com/augur-api#137.
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.
Metadata
Release files for simpleapps-com-augur-mcp 2026.10.2
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.10.2.tar.gz | 132.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| simpleapps_com_augur_mcp-2026.10.2-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 159.0 kB
Release files / simpleapps_com_augur_mcp-2026.10.2.tar.gz
| Download URL | simpleapps_com_augur_mcp-2026.10.2.tar.gz |
|---|---|
| Size | 132.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
6e896a4d3c7ceb51c685127a3241d1908c732f06d4548caad3de4e46d685e1aa
|
|
BLAKE2b-256 checksum How to use checksums |
948babc151b8b382af8e79acea8e53c8abbbee727d2eb8bd953853639f7ffde7
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","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.10.2-py3-none-any.whl
| Download URL | simpleapps_com_augur_mcp-2026.10.2-py3-none-any.whl |
|---|---|
| Size | 26.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
8e3c2db98eeefae72fb102e73f920930cc92b741fa797ba599892ea272f354a8
|
|
BLAKE2b-256 checksum How to use checksums |
f5f21451a3f61959fd93f593191da6dab3131504e87f6bcce577e949be1580fc
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.12.23 {"installer":{"name":"uv","version":"0.12.23","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}
|
