Auxiliar

Unified MCP capability index so your agent stops picking the wrong tool.

New contributor? See ONBOARDING.md for the fast path into the project — 30-second / 5-minute / 30-minute tours, architecture map, glossary, and links to every proposal + retro.

Your AI coding agent recommends services based on stale training data. It doesn't know SendGrid killed its free tier, that Auth.js is in maintenance mode, that Neon moved to usage-based pricing, or that an auxiliar-nfs-e + Surya parser hits 100% field accuracy on Brazilian invoices. This MCP server fixes that — one find_capability query searches across cloud services, ClawHub skills, MCP servers, plugins, parsers, and public-data lookups.

80+ Capabilities indexed (71 cloud services + skills, MCPs, plugins, parsers, public-data sources). Chrome-verified pricing. Reproducible eval scores on real-world corpora. No signup, no API key.

Install

# Claude Code
claude mcp add auxiliar -- npx auxiliar-mcp

# Cursor (add to .cursor/mcp.json)
{ "auxiliar": { "command": "npx", "args": ["auxiliar-mcp"] } }

# Any MCP client
npx auxiliar-mcp

What agents get wrong today

How it works

Twelve tools your agent can call. Four unified Capability tools (preferred for new agents — search across every kind of indexed thing) plus eight legacy single-purpose tools (still wired for backward-compat).

Unified Capability tools (v0.11.0+):

find_capability      → Ranked search across services / skills / MCPs / plugins / parsers / data
                       Filter by jtbd, element_type, agent_context. Pass a query or jtbd tag.
get_capability       → Full record by stable slug — pricing tiers, risks, install spec, deps,
                       eval records, distribution surfaces.
list_capabilities    → Filtered enumeration. element_type / category / jtbd / agent_context.
compare_capabilities → 2–5 ids → aligned row-per-field comparison structure.

Legacy single-purpose tools (still work; will be removed in a future version once consumers cut over):

recommend_service    → Best cloud service for your constraints
get_pricing          → Verified pricing tiers + hidden costs
get_risks            → Gotchas, breaking changes
check_compatibility  → 31 rules for known conflicts (Turso+Prisma, Better Auth+Workers, etc.)
setup_service        → CLI commands, env vars, signup URLs
list_services        → Cloud-service catalog by category
solve_task           → Per-task ranked tool recommendations (PDF OCR, NFS-e extraction, …)
list_solve_tasks     → Available /solve/ task rankings

Example (unified find_capability)

Agent: "I need to extract structured fields from Brazilian NFS-e invoices"

→ find_capability(query="Brazilian NFS-e invoice extraction", jtbd=["nfs-e-extraction"])

{
  "total_matches": 3,
  "results": [
    {
      "id": "nfs-e-parser",
      "element_type": "skill",
      "name": "nfs-e-parser",
      "score": 35,
      "page_url": "https://auxiliar.ai/skill/nfs-e-parser/",
      "install_command": "openclaw skills install tlalvarez/nfs-e-parser",
      "eval_score": 10.0,
      "jtbd_tags": ["nfs-e-extraction", "brazilian-invoice-parsing", "bookkeeping", ...]
    },
    {
      "id": "auxiliar-nfs-e",
      "element_type": "parser",
      "score": 30,
      "eval_score": 10.0,
      ...
    },
    ...
  ]
}

Example (leg

... View full README on GitHub