io.github.archonics/mcp-audit
Free context-engineering audits for AI agents. BYOK Anthropic key. Top-3 findings per scan.
Open source Open in the app JSON README (API)
About
Free context-engineering audits for AI agents. BYOK Anthropic key. Top-3 findings per scan.
Details
- Kind
- MCP servers
- Topic
- AI, RAG & memory
- Publisher
- archonics
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.4
- Last push
- 2026-05-14T02:28:14Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:02:26
- Updated
- 2026-08-29 03:02:26
- Origin id
io.github.archonics/mcp-audit
README
# Archonics MCP Audit Server
Free-tier context engineering audits for production AI agents, delivered as MCP tools you can call from Claude Desktop, Cursor, Claude Code, or any MCP-compatible client.
**What you get:** top-3 findings on your system prompts, tool definitions, or context packing, on demand, no account needed.
**What it costs:** nothing. The free scan is genuinely free. Upgrade paths to the $49 Instant Audit and $750 Full Audit are surfaced in the response footer; they're not paywalls on this tool.
## Why this exists
Most production agent failures aren't model failures — they're context engineering failures. Ambiguous instructions, underspecified tools, bloated context, no regression tests on prompt changes. Those problems are spottable by a trained reader. Archonics has trained that reader and published it as an MCP tool so you can get a second opinion on your agent's context without filing a support ticket.
The underlying audit engine applies Archonics Audit Methodology v1.0, the same spec that drives our paid audits.
## Tools
### `audit_system_prompt`
Paste a system prompt. Get back the three most important context engineering issues in it, ranked by severity, with specific recommendations.
**Covers:** role clarity, instruction conflicts, negative space, priority structure when instructions conflict, token efficiency, format specification precision, failure-mode coverage.
### `audit_tool_definition`
Paste a tool/function definition. Get back the three most important issues affecting how reliably the model will call it.
**Covers:** description quality (the "when to use this tool" question), parameter schema precision, parameter documentation, error response design, discoverability.
### `audit_context_packing`
Paste a representative context payload (or describe it structurally). Get back the three most important efficiency and quality issues.
**Covers:** content inventory, redundancy across sections, freshness/relevance, ordering, truncation risk, prompt-cache utilization.
## Installation
### Claude Desktop
Add to your `claude_desktop_config.json`:
```json
{
"mcpServers": {
"archonics-audit": {
"command": "npx",
"args": ["-y", "@archonics/mcp-audit"],
"env": {
"ANTHROPIC_API_KEY": "your-anthropic-api-key-here"
}
}
}
}
```
### Cursor
Add to your `.cursor/mcp.json`:
```json
{
"mcpServers": {
"archonics-audit": {
"command": "npx",
"args": ["-y", "@archonics/mcp-audit"],
"env": {
"ANTHROPIC_API_KEY": "your-anthropic-api-key-here"
}
}
}
}
```
### Claude Code
```bash
claude mcp add archonics-audit npx -y @archonics/mcp-audit
```
Then set `ANTHROPIC_API_KEY` in your environment.
## Why does it need my Anthropic API key?
The audit engine runs on Claude. You bring your own API key so:
1. Audit submissions go directly from your machine to Anthropic's API, never through Archonics servers.
2. Your costs are transparent — a typical audit uses 2,000–4,000 tokens, well under a penny.
3. There's no "free but actually limited" rate-limit surprise. Your API key, your limits.
If you'd rather not bring your own key, use the $49 Instant Audit at agent.market — we cover the API costs and return a full-methodology audit PDF.
## Privacy
Submitted content is processed ephemerally. No prospect content is retained on Archonics infrastructure or used to train any model. The API call pattern is: your client → your Anthropic API key → Anthropic → your client. Archonics servers are not in this path.
Aggregated, anonymized patterns across many audits may inform improvements to the methodology — "18 of 20 audited systems lacked prompt-regression tests" — but specific content never feeds that process.
Details: [archonics.ai/privacy](https://archonics.ai/privacy)
## Upgrade paths
If the free scan surfaces issues worth fixing, two paid tiers go deeper:
- **Instant Audit — $49 USDC via x402.** Full methodology applied programmatically to a system you submit. 5-10 page PDF report covering all four dimensions (prompt, tools, context, eval) rather than just three findings in one dimension. Listed at [agent.market/archonics](https://agent.market/archonics).
- **Full Audit — $750.** Human-reviewed audit of a complete agent system. 15-25 page report tuned to your team's context. Contact audits@archonics.ai.
## Contact
- Questions, feedback, or false-positive reports: audits@archonics.ai
- Methodology and full audit examples: [archonics.ai](https://archonics.ai)
- Issues with this MCP server: [github.com/archonics/mcp-audit/issues](https://github.com/archonics/mcp-audit)
## License
MIT. Use it, fork it, audit yourself.