Skip to main content
Yanked

This release has been yanked by its maintainers, and will be ignored by installers, except when explicitly specified.
Consider using release 2026.10.2 instead.

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):

  1. Environment variables — AUGUR_TOKEN + AUGUR_SITE_ID
  2. Explicit file — AUGUR_CREDS_FILE env var pointing to a JSON file (supports ~)
  3. Project file — .simpleapps/augur-api.json in the current working directory
  4. 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.9.5

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for simpleapps-com-augur-mcp 2026.9.5
File Size Uploaded
simpleapps_com_augur_mcp-2026.9.5.tar.gz 104.2 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for simpleapps-com-augur-mcp 2026.9.5
File Interpreter ABI Platform
simpleapps_com_augur_mcp-2026.9.5-py3-none-any.whl Python 3 none any Details

Total release size: 130.9 kB

Release files / simpleapps_com_augur_mcp-2026.9.5.tar.gz

Download URL simpleapps_com_augur_mcp-2026.9.5.tar.gz
Size 104.2 kB
Tags Source
SHA-256 checksum
How to use checksums
972c2d026147742ce3db255796fa1d59c91df34c486f8a7157ad20aa626741ed
BLAKE2b-256 checksum
How to use checksums
ebf947c869cd4b7ca9e1c6687794cde191ce66852b68af88d08341da884da255
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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.5-py3-none-any.whl

Download URL simpleapps_com_augur_mcp-2026.9.5-py3-none-any.whl
Size 26.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
062ff71ba7dd078ec6eb99a051e59129159bf379abd773e1bab31c0ed83babd6
BLAKE2b-256 checksum
How to use checksums
42cf2a734ba18a66e185ac99156b364cb53eda50892ea6641e6368e11c860d16
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via uv/0.12.19 {"installer":{"name":"uv","version":"0.12.19","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 history Release notifications | RSS feed

This release

2026.9.5 This release

2 release files

0.9.11

2 release files

0.9.10

2 release files

0.9.6

2 release files

0.9.5

2 release files

0.9.4

2 release files

0.9.3

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page