Skip to main content
Glama

@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.

npm version License MCP Compatible


⚡ 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

agentpr_guard_audit

Audits git diffs for AI hallucinations, typosquatting & architectural leaks.

tokenprune_wasm_trim

Prunes source code AST to save 50%-70% of prompt tokens in LLMs.

dockerlean_wasm_audit

Audits Dockerfile for 12 layer bloat anti-patterns and security risks.

sqltwin_stream_anonymize

Anonymizes SQL dumps preserving 100% of foreign keys and unique constraints.

terracost_blast_evaluate

Air-gapped blast radius & monthly FinOps cost delta for Terraform plans.

flaky_quarantine_analyze

Markov chain flaky test detection and automated Playwright/Jest isolation.

pack3d_wasm_pack

3D extreme point container packing and volumetric weight calculation.

cidr_shield_lookup

Microsecond threat & cloud datacenter IP range detection.

edgarpulse_parse_filing

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:

  1. Obtain an instant Ed25519 offline license key via Polar.sh Checkout

  2. 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=1

This 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 tools
agentpr_guard_auditA
Read-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_lookupA
Read-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_auditA
Read-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_filingA
Read-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_analyzeA
Read-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_packA
Read-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_anonymizeA
Read-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_evaluateA
Read-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_trimA
Read-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

    A4.4/5.0

    Scored across 9 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An enterprise-grade Model Context Protocol server that provides comprehensive GitHub repository analysis and AI-powered development assistance through 11 streamlined tools.
      11
      2
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Model Context Protocol server for security research automation, integrating multiple security testing tools into LLM-driven workflows for secret scanning, static analysis, and vulnerability discovery.
      57
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Local-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.
      1
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      A 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.
      8
      MIT