topai-mcp-suite
Provides a tool that audits Dockerfiles for 12 layer bloat anti-patterns and security risks.
Provides a tool that audits git diffs for AI hallucinations, typosquatting, and architectural leaks.
Provides a tool for Markov chain flaky test detection and automated Jest test isolation.
Provides a tool that evaluates Terraform plans for air-gapped blast radius and monthly FinOps cost delta.
@topaisaas/mcp-suite
Unified Model Context Protocol (MCP) Server for the TopAI Sovereign Appliance Suite.
Exposes 9 high-performance, deterministic developer tools natively to Claude Desktop, Cursor, and Windsurf via standard JSON-RPC 2.0 stdio.
⚡ 1-Click Integration in Claude Desktop or Cursor
Add this to your claude_desktop_config.json or .cursor/mcp.json:
{
"mcpServers": {
"topai-suite": {
"command": "npx",
"args": ["-y", "@topaisaas/mcp-suite"]
}
}
}Related MCP server: MCPwner
🛠️ The 9 Built-in Developer Tools
MCP Tool Name | Description |
| Audits git diffs for AI hallucinations, typosquatting & architectural leaks. |
| Prunes source code AST to save 50%-70% of prompt tokens in LLMs. |
| Audits Dockerfile for 12 layer bloat anti-patterns and security risks. |
| Anonymizes SQL dumps preserving 100% of foreign keys and unique constraints. |
| Air-gapped blast radius & monthly FinOps cost delta for Terraform plans. |
| Markov chain flaky test detection and automated Playwright/Jest isolation. |
| 3D extreme point container packing and volumetric weight calculation. |
| Microsecond threat & cloud datacenter IP range detection. |
| Deterministic SEC Form 4 and Form 8-K insider cluster buying alpha engine. |
🛡️ License & Quota Tollbooth
TopAI Sovereign MCP Suite comes with an out-of-the-box Free Sandbox of 25 tool runs, enabling immediate zero-friction evaluation directly inside Claude Desktop, Cursor, or Windsurf.
Activating Unlimited Pro / Lifetime Access
To unlock unlimited runs for production pipelines, developer environments, or CI/CD:
Obtain an instant Ed25519 offline license key via Polar.sh Checkout
Inject the key into your environment or client config:
{
"mcpServers": {
"topai-suite": {
"command": "npx",
"args": ["-y", "@topaisaas/mcp-suite"],
"env": {
"TOPAI_LICENSE_KEY": "TOPAI-PRO-XXXXXXXXXXXXXXXX"
}
}
}
}Emergency 24-Hour Production Grace Bypass
If a production pipeline exceeds its quota unexpectedly during an active incident:
export TOPAI_EMERGENCY_GRACE=1This grants a 24-hour non-blocking bypass so builds never fail during release freezes.
📄 License
Apache-2.0. Copyright (c) 2026 TopAI Sovereign Studio.
Available Tools
9 toolsagentpr_guard_auditARead-onlyIdempotent
Audits unified git diffs or Pull Requests for AI-hallucinated NPM/PyPI packages, typosquatting attacks, unauthorized boundary imports, and leaked secrets. Use when: Verifying code changes from AI coding agents (Cursor, Claude Code, Copilot) or reviewing PRs before merging into production repositories. Do not use when: Pruning TypeScript/JavaScript AST syntax or linting container Dockerfiles. Alternative: Use tokenprune_wasm_trim for AST prompt reduction, or dockerlean_wasm_audit for Dockerfile linting. Execution: Runs locally in-memory (<5ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: diff (required), licenseKey. Returns: report, markdown, securityNotice, hasVulnerability
cidr_shield_lookupARead-onlyIdempotent
Performs sub-millisecond offline Radix Trie Longest Prefix Match (LPM) on any IPv4 address to classify traffic as Datacenter/Cloud (AWS, GCP, Azure, Hetzner), VPN, Tor Exit Node, Public Proxy, or Clean Residential. Use when: Authenticating incoming HTTP requests, preventing bot scraping abuse, or assessing IP risk in auth flows without third-party network latency. Do not use when: Performing DNS lookups, WHOIS domain queries, or analyzing SQL databases. Alternative: Use sqltwin_stream_anonymize for database sanitization, or agentpr_guard_audit for code review. Execution: Runs locally in-memory (<0.01ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: ip (required), licenseKey. Returns: ip, isRisk, category, provider, +1 more
dockerlean_wasm_auditARead-onlyIdempotent
Statically lints and audits Dockerfiles for layer bloat, cache-busting RUN ordering, root user vulnerabilities, missing multi-stage build patterns, and excessive image footprint. Use when: Reviewing container configurations, CI/CD pipeline Dockerfiles, or developer images to minimize image size and security risks. Do not use when: Auditing git diffs or evaluating Terraform infrastructure plans. Alternative: Use agentpr_guard_audit for git diff security, or terracost_blast_evaluate for cloud infrastructure cost deltas. Execution: Runs locally in-memory (<5ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: dockerfileContent (required), licenseKey. Returns: report, markdown, efficiencyNotice
edgarpulse_parse_filingARead-onlyIdempotent
Parses raw SEC Form 4 and Form 8-K XML filings to extract C-suite insider transactions, open-market cluster purchases, vesting events, and calculate quantitative managerial conviction scores. Use when: Tracking corporate executive open-market purchases, insider sentiment, and institutional governance changes in financial workflows. Do not use when: Anonymizing SQL databases or evaluating container layer bloat. Alternative: Use sqltwin_stream_anonymize for database sanitization, or dockerlean_wasm_audit for container optimization. Execution: Runs locally in-memory (<5ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: filingXml (required), licenseKey. Returns: issuer, transactions, transactionsCount
flaky_quarantine_analyzeARead-onlyIdempotent
Analyzes multiple historical JUnit XML test run reports using two-state Markov chain transition matrices to statistically separate genuinely broken tests from nondeterministic flaky tests. Generates quarantine recommendations and test stability manifests. Use when: Triage of intermittent CI/CD pipeline failures, isolating nondeterministic test suites, and calculating test failure probability. Do not use when: Auditing unified git diffs or parsing database dumps. Alternative: Use agentpr_guard_audit for git security audits, or sqltwin_stream_anonymize for database anonymization. Execution: Runs locally in-memory (<10ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: junitXmlReports (required), licenseKey. Returns: summary, stableTests, quarantinedTests
pack3d_wasm_packARead-onlyIdempotent
Calculates 3D physical shipping carton packing arrangements for warehouse packages and e-commerce items using First-Fit Decreasing (FFD) and Extreme Point heuristics with full 6-axis orthogonal rotations. Use when: Optimizing warehouse carton selection, freight volumetric weight calculation, and logistics order fulfillment. Do not use when: Auditing code diffs, analyzing Terraform infrastructure, or performing software security reviews. Alternative: Use agentpr_guard_audit for PR security audits, or terracost_blast_evaluate for cloud infrastructure plans. Execution: Runs locally in-memory (<15ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: items (required), licenseKey. Returns: box, fitted, unfitted, totalWeightKg, +1 more
sqltwin_stream_anonymizeARead-onlyIdempotent
Streams and anonymizes PostgreSQL and MySQL database dumps, replacing PII (emails, phone numbers, names, IBANs) with synthetic values using HMAC format-preserving encryption while preserving 100% of foreign key joins, relational referential integrity, and unique constraints. Use when: Preparing staging or developer test database copies from production SQL dumps without exposing real user identities. Do not use when: Parsing financial SEC EDGAR filings or classifying IP addresses. Alternative: Use edgarpulse_parse_filing for SEC regulatory filings, or cidr_shield_lookup for IP address classification. Execution: Runs locally in-memory (<10ms), deterministic, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: sqlContent (required), licenseKey, secretSalt. Returns: anonymizedSql, rowsProcessed
terracost_blast_evaluateARead-onlyIdempotent
Evaluates Terraform plan JSON output to calculate infrastructure blast radius, identify high-risk stateful resource destructions (databases, storage buckets), and compute monthly FinOps cost delta estimations. Use when: Pre-apply CI/CD infrastructure reviews, FinOps budget validation, or assessing destruction risk before applying Terraform changes. Do not use when: Linting container configurations or evaluating test flakiness. Alternative: Use dockerlean_wasm_audit for container optimization, or flaky_quarantine_analyze for CI test stability. Execution: Runs locally in-memory (<10ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: planJson (required), licenseKey. Returns: report, markdown
tokenprune_wasm_trimARead-onlyIdempotent
Prunes TypeScript and JavaScript source code using AST parsing to extract public interfaces, type signatures, and exports while collapsing method implementations into concise summaries. Saves 50%-70% of LLM context window tokens without losing structural semantic information. Use when: Feeding large codebase files or libraries into LLM prompts for high-level architecture reasoning or planning. Do not use when: Auditing git diffs for security vulnerabilities or linting container configurations. Alternative: Use agentpr_guard_audit for PR security verification, or dockerlean_wasm_audit for container optimization. Execution: Runs locally in-memory (<10ms), read-only, idempotent, zero network calls, zero telemetry, air-gapped deterministic.
Inputs: sourceCode (required), filename, licenseKey. Returns: roiNotice, tokensSaved, prunedContent, savingsRatioPercent, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
Each tool targets a clearly distinct domain: AST pruning, PR/diff security, Dockerfile linting, IP classification, Terraform blast radius, 3D packing, flaky test analysis, SQL anonymization, and SEC filing parsing. Descriptions explicitly state when to use, when not to use, and alternatives, making misselection unlikely despite branded names.
All names use snake_case and end with a clear action verb (trim, audit, lookup, evaluate, pack, analyze, anonymize, parse). The pattern is consistent, but opaque product/mechanism prefixes like tokenprune, agentpr, and edgarpulse reduce predictability from the domain alone.
Nine tools is a well-scoped count for a utility suite, with no apparent filler or redundant operations. Each tool appears to earn its place as a distinct local analyzer.
Each tool provides a self-contained operation for its stated purpose, and the suite covers a broad set of engineering and data tasks. Minor gaps exist around composing outputs or applying remediation, but the read-only analyzer model does not require full CRUD lifecycle coverage.
Maintenance
Related MCP Connectors
LLM cost optimization gateway, repo token-waste auditor & model arbitrage MCP server.
BYOK AI router & FinOps control plane: audit token waste, check tool safety, and rank models.
A Model Context Protocol server for Wix AI tools
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
Related MCP Servers
- AlicenseAqualityDmaintenanceAn enterprise-grade Model Context Protocol server that provides comprehensive GitHub repository analysis and AI-powered development assistance through 11 streamlined tools.112MIT
- AlicenseNot gradedqualityCmaintenanceModel Context Protocol server for security research automation, integrating multiple security testing tools into LLM-driven workflows for secret scanning, static analysis, and vulnerability discovery.57Apache 2.0
- AlicenseNot gradedqualityBmaintenanceLocal-first code intelligence and safety layer for AI coding agents. MCP server exposes dependency graph, impact analysis, and AST-compressed repo context, backed by typed local memory, patch-scope safety gates, and git-independent transaction rollback.1MIT
- AlicenseAqualityBmaintenanceA secure, local-first MCP server for read-only inspection and troubleshooting of development environments, exposing narrow, typed, auditable capabilities for repository inspection, log summarization, Docker review, and security scanning without granting unrestricted machine access.8MIT