Skill

augur-api

Augur API integration via MCP. Covers service discovery, multi-site CRUD operations across Augur microservices, and credential resolution. Use when querying or modifying Augur data (contacts, transactions, inventory, etc.).

Install

npx claudepluginhub simpleapps-com/augur-skills --plugin simpleapps

Tool Access

This skill uses the workspace's default tool permissions.

Preview

MCP server exposing Augur microservices through 7 generic tools.

SKILL.md

Similar Skills

design-system

Generates design tokens/docs from CSS/Tailwind/styled-components codebases, audits visual consistency across 10 dimensions, detects AI slop in UI.

team-skills-platform

163.7k

ui-demo

Records polished WebM UI demo videos of web apps using Playwright with cursor overlay, natural pacing, and three-phase scripting. Activates for demo, walkthrough, screen recording, or tutorial requests.

team-skills-platform

163.7k

kotlin-patterns

Delivers idiomatic Kotlin patterns for null safety, immutability, sealed classes, coroutines, Flows, extensions, DSL builders, and Gradle DSL. Use when writing, reviewing, refactoring, or designing Kotlin code.

team-skills-platform

163.7k

Stats

Parent Repo Stars0

Parent Repo Forks0

Last CommitFeb 24, 2026

Actions

View Source View Plugin View on GitHub View README

Augur API

MCP server exposing Augur microservices through 7 generic tools.

Tools

Tool	Purpose
`augur_discover`	List services or endpoints for a service
`augur_sites`	List configured sites with default flag
`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)

All 5 data tools (augur_list, augur_get, augur_create, augur_update, augur_delete) accept an optional site parameter to target a specific site. Omit site to use the default.

Usage Pattern

Always start with discovery:

augur_sites() — see which sites are configured and which is default
augur_discover() — lists all available services
augur_discover(service="<name>") — lists endpoints for a specific service
Use data tools for CRUD, passing site when targeting a non-default site

Do NOT hardcode service names or endpoints. Use augur_discover to find them at runtime.

Authentication

Credentials resolve automatically from .simpleapps/ directories.

Resolution order (first match wins):

Env vars — AUGUR_TOKEN + AUGUR_SITE_ID
Explicit file — AUGUR_CREDS_FILE env var pointing to a JSON file
Project file — <cwd>/.simpleapps/augur-api.json
Global file — ~/.simpleapps/augur-api.json

Project and global files are merged (project takes precedence).

Single-site format

{
  "siteId": "my-site",
  "jwt": "my-token"
}

Multi-site format

{
  "site-a": { "jwt": "token-a" },
  "site-b": { "jwt": "token-b" }
}

API Reference

Documentation hub: https://augur-api.info/

Service directory — https://items.augur-api.com/llms.txt lists all available services
Per-service docs — https://{service}.augur-api.com/llms.txt (LLM-friendly), /openapi.json, /postman.json, /endpoints.jsonl
FAQ for agents — https://augur-api.info/faq.md (auth, pagination, rate limits)

Services include items, pricing, commerce, orders, customers, payments, shipping, open-search, and more. Use augur_discover at runtime rather than hardcoding service names.

When Auth Fails

If tools return authentication errors:

Check for .simpleapps/augur-api.json in the project directory or home directory
Verify the file contains valid credentials (single-site or multi-site format)
Fallback: set AUGUR_TOKEN and AUGUR_SITE_ID env vars