io.github.auxiliar-ai/auxiliar-mcp
Eval-backed discovery for the auxiliar.ai gateway — the best web-access provider per job, measured.
Installation
Ajoutez ceci à la configuration MCP de votre client (Claude Desktop : claude_desktop_config.json ; Cursor : .cursor/mcp.json ; VS Code et les autres utilisent la même forme « mcpServers »).
auxiliar-mcpclaude mcp add auxiliar-mcp -- npx -y auxiliar-mcp@0.23.0
{
"mcpServers": {
"auxiliar-mcp": {
"command": "npx",
"args": [
"-y",
"auxiliar-mcp@0.23.0"
]
}
}
}
Documentation
Tirée du README du projet sur GitHub, actualisée chaque semaine. Les liens ouvrent GitHub.
auxiliar-mcp
Eval-backed tool discovery for AI agents, on the auxiliar.ai web-access gateway — one API key for 24 search, scraping, browser-automation and voice APIs, upstream keys injected server-side, usage at each provider's real metered price.
Ask it "what's the best provider for this job?" and it answers from measured public benchmarks — every provider runs the identical task corpus per verb; scorecards carry their run dates; weak scores are published, not hidden.
Install
claude mcp add auxiliar -- npx auxiliar-mcp
or in any MCP client config:
{ "mcpServers": { "auxiliar": { "command": "npx", "args": ["auxiliar-mcp"] } } }
Tools
| Tool | What it does |
|---|---|
recommend_tools | Best provider(s) for a job (search, scrape, crawl, extract_ai, extract_rules, answer, screenshot, scrape_domain, act, act_agent, serp, parse, watch), ranked by measured quality/latency/cost/errors. Optional optimize_for, max_latency_ms, max_cost_usd, limit. |
get_scorecard | The full leaderboard for one verb — every scored provider, raw metrics, run dates. |
get_provider | One provider in full: route, pricing, choose/avoid guidance, all its dated scorecards. |
about_auxiliar | What the gateway is, how to get a key, how to call it. |
Every response carries the run date behind each number (measured_on, latest_run), the ranking context (rank #n of m), honest caveats, providers excluded_by_constraints (never silently dropped), and gated_not_scored entries for providers that couldn't be scored on the shared corpora.
Recommendations return an executable call pattern:
https://api.auxiliar.ai/{provider}/{provider-native-path}
Authorization: Bearer <your auxiliar API key>
Same paths, parameters and responses as each provider's own docs — the gateway injects the upstream key server-side. Get a key (with $5 free credit, no card) at auxiliar.ai.
Where the data comes from
Benchmark data loads at runtime from auxiliar.ai/evals.json (1h in-memory cache) and falls back to a bundled snapshot offline — responses declare which via data_source. The same data renders the human-readable scorecards at auxiliar.ai/tools. Rankings carry no house incentive: the gateway's fee is flat at credit top-up, so nothing is earned by steering you toward pricier providers.
Development
npm install
npm run build # tsc → dist/ (+ bundled data snapshot)
npm test # unit tests + end-to-end stdio round-trip
npm run update-fallback # refresh src/data/evals-fallback.json from production
Releasing: bump the version in package.json and server.json (two spots) — npm run check-versions (run automatically at prepublish) enforces sync — then npm publish and mcp-publisher publish.
Roadmap
- v0.23 (this release) — eval-backed discovery.
- v1.0 — in-loop execution: call the providers through the gateway from this MCP (
web_search,scrape,extract,crawl, …), routed by the same measured rankings.
License
MIT
Questions fréquentes
Qu'est-ce que io.github.auxiliar-ai/auxiliar-mcp ?
Eval-backed discovery for the auxiliar.ai gateway — the best web-access provider per job, measured.
Comment installer io.github.auxiliar-ai/auxiliar-mcp ?
Il s'exécute sur votre machine. Dans Claude Code : claude mcp add auxiliar-mcp -- npx -y auxiliar-mcp@0.23.0. Pour les autres clients, collez la configuration JSON de cette page dans leurs réglages MCP.
Faut-il une clé API pour io.github.auxiliar-ai/auxiliar-mcp ?
Son entrée au registre n'indique aucune clé ni secret obligatoire. Certaines fonctions peuvent tout de même demander un compte auprès du service auquel il se connecte.
io.github.auxiliar-ai/auxiliar-mcp est-il open source ?
Oui. Son code est sur GitHub sous licence MIT.
Qui maintient io.github.auxiliar-ai/auxiliar-mcp ?
Il est publié par auxiliar-ai. AI.tn le référence sans le maintenir ni le recommander.
Issu du registre MCP officiel. Être listé n'est pas une recommandation : vérifiez le code et les permissions d'un serveur avant de lui donner accès à vos données.