Koskamo

IA-QA MCP

Provides 152 free QA and LLM testing tools for AI agents, including prompt injection scans, RAG evaluations, security audits, and CI workflow generation. It returns structured verdicts (PASS/FAIL) to gate pipelines, supporting both hosted execution and local self-healing utilities.

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

IA-QA MCP logo, by IA-QACommunity listingStreamable HTTPNo sign-inEndpoint checked 2026-11-07Published by IA-QA
You need:No account, no key.
MCP endpoint (Streamable HTTP)
https://www.ia-qa.com/mcp
Vendor documentation

What its tools do

152 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (148)

152 of 152 have a description · 152 of 152 declare behavior hints · 145 of 152 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Scan prompts for injection and PII leaks
  • Evaluate RAG pipelines and LLM outputs
  • Check MCP server health and tool lists
  • Generate CI workflows for test gating

Source and maintenance

Community listingRegistry 1.1.1
Maintenance checked

Protocol and capabilities

Server
ia-qa-toolbox 1.0.0
MCP protocol negotiated in check
2025-11-25
Tools
152 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {}
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

IA-QA serves two kinds of user, and every tool produces an actionable verdict (pass/fail, score, diff) — the testing tools also return gate: pass | review | fail, the one field to branch a CI step on; LLM tools are BYOK (the user supplies their own API key). USE AI TO TEST — a QA engineer who wants AI to help: test cases from a ticket (jira_to_test_suite, generate_test_cases), likely bugs and risk from a diff (analyze_diff_bugs, run_pr_gate_pipeline), UI selector drift between two page captures (diff_mappings; sandbox_scenario supplies captures whose verdict is known). Repairing their end-to-end tests needs a browser on their machine: that is the local app @ia-qa/pal (with its own stdio MCP server, ia-qa-pal-mcp), not this server — point them to https://www.ia-qa.com/devtools/pal/tutorial, and to the step-by-step method at https://www.ia-qa.com/method#augmented-qa-journey. TEST WHAT USES AI — someone shipping an LLM, a RAG pipeline or an agent: when you do not know which tools fit, call get_testing_guidelines with no topic first: it maps each goal to the tools to call and the output field to gate on. To discover any tool without loading every schema, call find_tool with a keyword or category. These tools are operated on behalf of a human: before running a tool, say in one line what it does and what its verdict means, and proactively suggest a relevant tool when their task fits (testing a prompt, checking a RAG answer, scanning for PII or prompt injection, gating a PR). The same tools are also available from the shell via @ia-qa/cli, and local selector self-healing via @ia-qa/self-healing. Feedback wanted, not praise: after using a tool, call rate_tool when you have a real signal — low (1-2) if the output was wrong or a poor fit, high (4-5) only if it genuinely solved your need — and say in the comment what you were trying to do. Skip rating if you have nothing useful to report. Report a verdict as a careful tester would: gate review means it could not decide, so say that and never round it to a pass; relay what a result says it did not prove, and explain why it matters to the person you work for.

Tools

152 advertised

get_testing_guidelines
Advertised by the server during the last successful anonymous check.
Advertised read-only

Query the IA-QA methodology knowledge base. Returns structured testing guidelines, assertion strategies, thresholds, best practices, and relevant MCP tools for a given topic. Call without a topic to list all available topics. Topics: llm-unit-testing, rag-pipeline, prompt-stability, prompt-ab-testing, embedding-quality, eval-framework, semantic-testing, auto-testing, security, api-testing, ci-cd, multimodal, llm-data-security, agent-observability, pro-tips, learning-paths, golden-dataset, selector-drift, qa-recipes, playbooks. Not sure where to start testing an LLM, RAG pipeline or agent? Call without a topic (or with "start-here"): it maps what you are testing to the tools to call and the output field to gate CI on. A plain question such as "how do I test my RAG" also resolves to the right topic.

get_testing_guidelines input schema
{
  "type": "object",
  "examples": [
    {
      "topic": "rag-pipeline"
    }
  ],
  "properties": {
    "topic": {
      "enum": [
        "start-here",
        "llm-unit-testing",
        "rag-pipeline",
        "prompt-stability",
        "prompt-ab-testing",
        "embedding-quality",
        "eval-framework",
        "semantic-testing",
        "auto-testing",
        "security",
        "api-testing",
        "ci-cd",
        "multimodal",
        "llm-data-security",
        "agent-observability",
        "pro-tips",
        "learning-paths",
        "golden-dataset",
        "selector-drift",
        "qa-recipes",
        "playbooks"
      ],
      "type": "string",
      "description": "The testing topic to retrieve guidelines for. Omit to get the start-here map and the full list of available topics."
    }
  }
}
get_testing_guidelines output schema
{
  "type": "object",
  "properties": {
    "tip": {
      "type": "string"
    },
    "topic": {},
    "usage": {
      "type": "string"
    },
    "keywords": {
      "type": "array"
    },
    "start_here": {
      "type": "object"
    },
    "available_topics": {
      "type": "array"
    }
  },
  "additionalProperties": true
}
get_testing_guidelines annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
find_tool
Advertised by the server during the last successful anonymous check.
Advertised read-only

Search available MCP tools by keyword or category before calling them. Returns names, descriptions and, on request, inputSchemas. Queries are logged 90 days, screened for credentials and personal data. Categories: data, dev, encoding, eval, integrations, llm, meta, qa, rag, security, text, web.

find_tool input schema
{
  "type": "object",
  "examples": [
    {
      "query": "leaked api key"
    }
  ],
  "required": [
    "query"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "Keywords, e.g. \"cors\", \"token\", \"vector\", \"json\""
    },
    "category": {
      "type": "string",
      "description": "Optional filter, one of the categories above. Any other value is refused."
    },
    "max_results": {
      "type": "number",
      "description": "Maximum tools to return (default 10, max 50). Best match first."
    },
    "with_schema": {
      "type": "boolean",
      "description": "Set true to include inputSchema in results (default: false)"
    }
  }
}
find_tool output schema
{
  "type": "object",
  "properties": {
    "hint": {},
    "tool": {},
    "count": {
      "type": "number"
    },
    "query": {},
    "score": {},
    "tools": {
      "type": "array"
    },
    "category": {},
    "truncated": {
      "type": "boolean"
    },
    "total_matches": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
find_tool annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_test_cases
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate a set of test cases (valid, edge, invalid, pairwise) for a given feature description. Declared constraints drive the boundaries: a length or numeric bound ("[8-64]", "min 8 chars", "at least 8 characters" — read from inputs, and from the feature prose when a sentence names exactly one field) yields the last accepted value AND the first rejected one; a format (email/url/uuid, from the type, the field name or the wording) yields malformed-value cases. A bound nobody declared is labelled as this tool's assumption, not as expected behaviour. gherkinFormat renders every case (cap 200, stated in the output) and gherkinScenarioCount lets you check it against totalCases.

generate_test_cases input schema
{
  "type": "object",
  "examples": [
    {
      "feature": "Login form with email and password"
    }
  ],
  "required": [
    "feature"
  ],
  "properties": {
    "inputs": {
      "type": "string",
      "description": "Optional: list of input parameters (one per line, e.g. \"email: string [required]\", \"password: string [required, min 8 chars]\", \"age: number [18-99]\")"
    },
    "feature": {
      "type": "string",
      "description": "Feature or function to test. Be specific: describe inputs, expected behaviour, context. Constraints stated here (\"password must be at least 8 characters\") are used when the sentence names exactly one field."
    }
  }
}
generate_test_cases output schema
{
  "type": "object",
  "properties": {
    "feature": {
      "type": "string"
    },
    "test_cases": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "parsedInputs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "gherkinFormat": {
      "type": "string"
    },
    "gherkinScenarioCount": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
generate_test_cases annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
jira_to_test_suite
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Turn a Jira ticket into a test suite: Gherkin scenarios, E2E steps, API tests, test data and the ambiguities to clarify. Pass the issue object, or Jira credentials to fetch it. It never invents: a thin ticket returns an empty suite with verdict INCOMPLETE_SPEC and the questions to ask. test_suite._gherkin_warnings is a deterministic syntax check. BYOK: your LLM key.

jira_to_test_suite input schema
{
  "type": "object",
  "examples": [
    {
      "issue": {
        "key": "PROJ-1",
        "summary": "Password reset by email",
        "description": "A registered user can request a reset link; the link expires after 30 minutes."
      },
      "model": "gpt-4o-mini",
      "api_key": "<your-api-key>"
    }
  ],
  "required": [
    "api_key",
    "model"
  ],
  "properties": {
    "issue": {
      "type": "object",
      "description": "The ticket: key, summary, description, and optionally status, issue_type, priority, labels, comments (fetch_jira_issue returns this shape).",
      "additionalProperties": true
    },
    "model": {
      "type": "string",
      "description": "e.g. \"gpt-4o-mini\", \"claude-haiku-4-5-20251001\", \"gemini-3.5-flash\"."
    },
    "api_key": {
      "type": "string",
      "description": "Your LLM provider key."
    },
    "issue_key": {
      "type": "string",
      "description": "e.g. \"PROJ-123\", to fetch with the jira_* fields."
    },
    "jira_email": {
      "type": "string"
    },
    "jira_token": {
      "type": "string"
    },
    "max_tokens": {
      "type": "integer",
      "default": 8192,
      "description": "Default 8192."
    },
    "jira_base_url": {
      "type": "string"
    },
    "confluence_pages": {
      "type": "array",
      "items": {
        "type": "object",
        "additionalProperties": true
      },
      "description": "Pages from fetch_confluence_page, as documentation."
    }
  }
}
jira_to_test_suite output schema
{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string"
    },
    "issue_key": {
      "type": "string"
    },
    "issue_url": {
      "type": "string"
    },
    "latency_ms": {
      "type": "number"
    },
    "model_used": {
      "type": "string"
    },
    "test_suite": {
      "type": "object"
    },
    "tokens_used": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
jira_to_test_suite annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
analyze_diff_bugs
Advertised by the server during the last successful anonymous check.
Advertised read-only

Pattern-based diff linter: flags a fixed set of risky shapes in changed code — query-string interpolation (SQL/Cypher/Mongo injection shape), shell interpolation, eval/new Function, empty catch blocks, regex built from a variable, fewer catch blocks than before, and named authorization guards that disappeared. Every finding cites the line that produced it. It does NOT do data-flow analysis: it cannot follow a value to a sink, across functions or files, and an empty result is not a safety verdict (the response lists what it did not analyse). Advisory triage — use a static analyser for a real security gate.

analyze_diff_bugs input schema
{
  "type": "object",
  "examples": [
    {
      "version1": "if (amount > 0) charge(amount);",
      "version2": "if (amount >= 0) charge(amount);"
    }
  ],
  "required": [
    "version2"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional PR title or feature context for better analysis"
    },
    "version1": {
      "type": "string",
      "description": "Original code (before changes). If omitted, only the new version is analysed."
    },
    "version2": {
      "type": "string",
      "description": "New/modified code (after changes)"
    }
  }
}
analyze_diff_bugs output schema
{
  "type": "object",
  "properties": {
    "bugs": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "disclaimer": {
      "type": "string"
    },
    "notAnalysed": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "overallRisk": {
      "type": "string"
    },
    "rulesApplied": {
      "type": "number"
    },
    "scannedLines": {
      "type": "number"
    },
    "totalSuggestions": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
analyze_diff_bugs annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
run_pr_gate_pipeline
Advertised by the server during the last successful anonymous check.
Advertised read-only

Review triage for a pull request. Takes a unified git diff (`git diff HEAD`) and returns: diff-lint findings with the lines that produced them, regression impact areas, a risk score 0–100 with the factors that built it (churn, files touched, sensitive paths, whether any test file changed, lint severities, impacted risk areas), generated test cases, and a PASS / CONDITIONAL / BLOCK recommendation. Advisory: the score measures properties of the diff, not the correctness of the change — it does not read the code semantically and does not replace a reviewer or a static analyser. See notAnalysed in the response.

run_pr_gate_pipeline input schema
{
  "type": "object",
  "examples": [
    {
      "git_diff": "diff --git a/pay.js b/pay.js\n--- a/pay.js\n+++ b/pay.js\n@@ -1 +1 @@\n-if (amount > 0) charge(amount);\n+if (amount >= 0) charge(amount);"
    }
  ],
  "required": [
    "git_diff"
  ],
  "properties": {
    "context": {
      "type": "string",
      "description": "Optional PR title or description for richer analysis"
    },
    "git_diff": {
      "type": "string",
      "description": "Unified git diff (output of `git diff HEAD` or copied from GitHub diff view)"
    }
  }
}
run_pr_gate_pipeline output schema
{
  "type": "object",
  "properties": {
    "sla": {},
    "high": {},
    "topBugs": {
      "type": "array"
    },
    "critical": {},
    "bugsFound": {
      "type": "number"
    },
    "riskLevel": {},
    "riskScore": {},
    "disclaimer": {
      "type": "string"
    },
    "impactAreas": {
      "type": "array"
    },
    "inputFormat": {
      "type": "string"
    },
    "notAnalysed": {
      "type": "array"
    },
    "riskFactors": {
      "type": "array"
    },
    "changedFiles": {},
    "severityLevel": {},
    "testCasesGenerated": {},
    "mergeRecommendation": {}
  },
  "additionalProperties": true
}
run_pr_gate_pipeline annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
diff_mappings
Advertised by the server during the last successful anonymous check.
Advertised read-only

Diff a baseline page mapping against a current one and return a CI-style verdict: PASS / FIX / BLOCK, plus per-element drift (ok, renamed, healable, ambiguous, lost, added, rebound). Pure and deterministic — provide two mappings as JSON with "elements" arrays of {role, name, selector, context?}. Use the companion @ia-qa/self-healing package (npm install -g @ia-qa/self-healing) to capture mappings from your app via its local MCP server ia-qa-heal-mcp, or paste the snippet from ia-qa.com/devtools/selector-drift into your browser console.

diff_mappings input schema
{
  "type": "object",
  "examples": [
    {
      "after": {
        "page": "login",
        "elements": [
          {
            "name": "Log in",
            "role": "button",
            "selector": "#submit"
          }
        ]
      },
      "before": {
        "page": "login",
        "elements": [
          {
            "name": "Sign in",
            "role": "button",
            "selector": "#submit"
          }
        ]
      }
    }
  ],
  "required": [
    "before",
    "after"
  ],
  "properties": {
    "after": {
      "type": "object",
      "description": "Current page mapping: same shape as before, captured after the UI change."
    },
    "before": {
      "type": "object",
      "description": "Baseline page mapping: { page, url, capturedAt, elements: [{role, name, selector, context?}] }. Captured before a UI change."
    }
  }
}
diff_mappings output schema
{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array"
    },
    "added": {
      "type": "array"
    },
    "counts": {
      "type": "object"
    },
    "verdict": {}
  },
  "additionalProperties": true
}
diff_mappings annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
sandbox_scenario
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get a ready-made selector-drift test case with a known-correct answer, for testing this MCP server or an agent workflow end to end. Each scenario is a real DOM capture of a deliberately breakable app, taken before and after one specific UI change (a renamed label, two swapped buttons, a duplicated locator, an element moved behind a menu…), plus the verdict those two contracts MUST produce. Call with no arguments to list the scenarios; call with a scenario id to get "baseline" and "current" mappings. THE LOOP: pass baseline and current to diff_mappings, then compare its "verdict" and "counts" to this tool's "expected" — they must match exactly. A mismatch means this server's diff engine has drifted, not that your inputs are wrong. Deterministic and offline: the captures are committed fixtures, identical on every call. Try it live at https://www.ia-qa.com/devtools/sandbox

sandbox_scenario input schema
{
  "type": "object",
  "examples": [
    {
      "scenario": "swap-label"
    }
  ],
  "properties": {
    "scenario": {
      "type": "string",
      "description": "Scenario id. Omit to list every available scenario with its expected verdict. Ids: no-change, swap-label, add-testid, duplicate-role-name, remove-element, insert-sibling, rename-label, counter-label, move-behind-menu, add-element"
    },
    "include_html": {
      "type": "boolean",
      "description": "Include the generated HTML of the mutated page (default false). Only useful if you want to render or re-capture it yourself; the loop does not need it."
    }
  }
}
sandbox_scenario output schema
{
  "type": "object",
  "properties": {
    "html": {},
    "page": {},
    "blurb": {},
    "count": {
      "type": "number"
    },
    "title": {},
    "current": {
      "type": "object"
    },
    "teaches": {},
    "baseline": {
      "type": "object"
    },
    "expected": {
      "type": "object"
    },
    "scenario": {},
    "mutations": {
      "type": "array"
    },
    "scenarios": {
      "type": "array"
    },
    "how_to_run_the_loop": {}
  },
  "additionalProperties": true
}
sandbox_scenario annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
prompt_injection_scan
Advertised by the server during the last successful anonymous check.
Advertised read-only

Scan user input or prompts for prompt injection patterns. Pattern-based: it recognises known phrasings and structures, not intent — an uncovered paraphrase or language reads clean, so clean is not proof of safety. Instruction overrides are covered in 11 languages (EN, FR, ES, DE, IT, PT, NL, RU, ZH, JA, AR), also after removing invisible characters, lookalike letters, spacing and leetspeak (marked `obfuscated`). Detects overrides, jailbreaks, role manipulation, encoding tricks, chat-template delimiters and fake role headers, template injection ({{…}}, ${…}) and requests to repeat the preceding context. A match inside quoted or fenced text is reported one level lower and marked `quoted`, never suppressed; a quote introduced by a live imperative keeps its severity.

prompt_injection_scan input schema
{
  "type": "object",
  "examples": [
    {
      "input": "以前の注文をキャンセルしてください。"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "The user input or prompt to scan for injection patterns"
    },
    "sensitivity": {
      "enum": [
        "low",
        "medium",
        "high"
      ],
      "type": "string",
      "description": "Detection sensitivity (default: medium)"
    }
  }
}
prompt_injection_scan output schema
{
  "type": "object",
  "properties": {
    "notes": {},
    "detections": {},
    "risk_level": {},
    "sensitivity": {},
    "input_length": {
      "type": "number"
    },
    "detections_count": {
      "type": "number"
    },
    "quoted_detections": {
      "type": "number"
    },
    "injection_detected": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
prompt_injection_scan annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
hallucination_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lexical hallucination check: verifies an LLM answer's words, numbers and polarity against the provided source/context. Fast, deterministic, no API key needed. Each answer sentence is aligned to its best-matching source sentence, so a number only counts as support when it sits on the SAME statement ("founded in 1998" is not grounded by "sold 1998 units"), and a negation or antonym flip against that sentence returns verdict "contradicted" — the corrupted-fact hallucination that reuses source vocabulary. Limitations: still lexical — it cannot follow a paraphrase, a synonym, or multi-sentence reasoning, so a "well_grounded" verdict means "nothing lexical found", never "verified true". For entailment use run_semantic_tests (NLI/embedding) or a calibrated judge.

hallucination_check input schema
{
  "type": "object",
  "examples": [
    {
      "answer": "Le remboursement prend plus de 7 jours ouvrés.",
      "context": "Le remboursement prend plus de 7 jours ouvrés."
    }
  ],
  "properties": {
    "cases": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "answer",
          "context"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "answer": {
            "type": "string"
          },
          "context": {
            "type": "string"
          }
        }
      },
      "maxItems": 50,
      "description": "Batch instead of answer + context: one result per case, and the worst gate overall."
    },
    "answer": {
      "type": "string",
      "description": "The LLM answer to verify (with context)."
    },
    "strict": {
      "type": "boolean",
      "description": "Every sentence must be supported (default false)."
    },
    "context": {
      "type": "string",
      "description": "The source text that should ground it."
    }
  }
}
hallucination_check output schema
{
  "type": "object",
  "properties": {
    "detail": {
      "type": "string"
    },
    "message": {
      "type": "string"
    },
    "numbers": {},
    "overlap": {
      "type": "number"
    },
    "verdict": {
      "type": "string"
    },
    "analysis": {},
    "entities": {},
    "grounded": {
      "type": "boolean"
    },
    "sentence": {},
    "total_words": {
      "type": "number"
    },
    "matched_words": {
      "type": "number"
    },
    "contradictions": {},
    "grounded_count": {
      "type": "number"
    },
    "unbound_claims": {},
    "grounding_score": {},
    "total_sentences": {
      "type": "number"
    },
    "ungrounded_count": {
      "type": "number"
    },
    "unsupported_claims": {}
  },
  "additionalProperties": true
}
hallucination_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
run_eval_contract
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Run an IA-EVAL test suite (.ia-eval.yaml contract): call the model per scenario; return passed (true, false, null if undecided) and a verdict (PASS, FAIL, PARTIAL). Expectations are assertions that fail a scenario whatever its score; evaluators give the score. Hosted: pass inline_contract. validate_only calls no model.

run_eval_contract input schema
{
  "type": "object",
  "examples": [
    {
      "inline_contract": {
        "metadata": {
          "name": "smoke",
          "version": "1.0"
        },
        "scenarios": [
          {
            "id": "capital",
            "input": "Capital of France? One word.",
            "ground_truth": "Paris"
          }
        ],
        "expectations": {
          "contains": [
            "Paris"
          ],
          "min_score": 70
        }
      }
    }
  ],
  "properties": {
    "api_keys": {
      "type": "object",
      "properties": {
        "hf": {
          "type": "string"
        },
        "xai": {
          "type": "string"
        },
        "groq": {
          "type": "string"
        },
        "google": {
          "type": "string"
        },
        "openai": {
          "type": "string"
        },
        "mistral": {
          "type": "string"
        },
        "deepseek": {
          "type": "string"
        },
        "anthropic": {
          "type": "string"
        }
      },
      "description": "Your keys per provider. Only Groq falls back to the server key; any other provider needs yours."
    },
    "overrides": {
      "type": "object",
      "properties": {
        "model": {
          "type": "string"
        },
        "provider": {
          "type": "string"
        },
        "temperature": {
          "type": "number"
        },
        "system_prompt": {
          "type": "string"
        }
      },
      "description": "Override contract defaults"
    },
    "contract_path": {
      "type": "string",
      "description": "A .ia-eval.yaml under the server's working directory (local use)."
    },
    "validate_only": {
      "type": "boolean",
      "description": "Check the contract against the IA-EVAL schema and stop: no model call, no key, deterministic. Returns valid + issues instead of throwing. Gate a PR that edits a contract on valid."
    },
    "inline_contract": {
      "type": "object",
      "description": "The contract as an object: \"metadata\" ({name, version, model?, provider?}), \"expectations\", \"evaluators\" and \"scenarios\" ([{id, input, expectations?}]). generate_eval_yaml scaffolds one.",
      "additionalProperties": true
    }
  }
}
run_eval_contract output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "issues": {},
    "summary": {
      "type": "object"
    },
    "metadata": {
      "type": "object"
    },
    "warnings": {},
    "contract_path": {},
    "scenario_results": {}
  },
  "additionalProperties": true
}
run_eval_contract annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
guardrail_test
Advertised by the server during the last successful anonymous check.
Advertised read-only

Test an LLM response against a set of guardrail rules: must-include, must-not-include, max length, required format, language, forbidden patterns, and custom regex. Returns pass/fail per rule.

guardrail_test input schema
{
  "type": "object",
  "examples": [
    {
      "rules": [
        {
          "type": "must_include",
          "value": "refund"
        },
        "no_pii"
      ],
      "response": "Your refund is approved."
    }
  ],
  "required": [
    "response",
    "rules"
  ],
  "properties": {
    "rules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "enum": [
              "must_include",
              "must_not_include",
              "max_length",
              "min_length",
              "format",
              "regex_match",
              "regex_not_match",
              "starts_with",
              "ends_with",
              "word_count_max",
              "word_count_min"
            ],
            "type": "string"
          },
          "label": {
            "type": "string",
            "description": "Optional human-readable label"
          },
          "value": {
            "type": "string",
            "description": "Value for the rule (text, number as string, regex, or format name)"
          }
        }
      },
      "description": "Array of guardrail rules to check"
    },
    "response": {
      "type": "string",
      "description": "The LLM response to test"
    }
  }
}
guardrail_test output schema
{
  "type": "object",
  "properties": {
    "pass": {
      "type": "boolean"
    },
    "rule": {},
    "label": {},
    "value": {},
    "detail": {
      "type": "string"
    },
    "failed": {},
    "passed": {},
    "results": {},
    "all_passed": {
      "type": "boolean"
    },
    "total_rules": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
guardrail_test annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
run_semantic_tests
Advertised by the server during the last successful anonymous check.
Advertised read-only

Semantic assertion primitive: compare actual vs expected text pairs using cosine similarity + ROUGE-L. Two modes: tfidf (default, free, no API key) or embeddings (OpenAI text-embedding-3-small, BYOK, true semantic similarity). Returns per-case PASS/FAIL verdicts and an overall verdict. CI-ready: pipe the JSON verdict field to gate a build.

run_semantic_tests input schema
{
  "type": "object",
  "examples": [
    {
      "cases": [
        {
          "actual": "Paris is the capital of France",
          "expected": "The capital of France is Paris"
        }
      ]
    }
  ],
  "required": [
    "cases"
  ],
  "properties": {
    "mode": {
      "enum": [
        "tfidf",
        "embeddings"
      ],
      "type": "string",
      "description": "tfidf (default): fast, free, lexical. embeddings: OpenAI text-embedding-3-small, true semantic similarity, requires api_key."
    },
    "cases": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "actual",
          "expected"
        ],
        "properties": {
          "id": {
            "type": "string",
            "description": "Optional identifier for this case."
          },
          "actual": {
            "type": "string",
            "description": "The text produced by your LLM/system."
          },
          "expected": {
            "type": "string",
            "description": "The reference/ground-truth text."
          }
        }
      },
      "maxItems": 50,
      "description": "Array of (actual, expected) pairs to evaluate."
    },
    "api_key": {
      "type": "string",
      "description": "OpenAI API key — required only when mode is embeddings."
    },
    "thresholds": {
      "type": "object",
      "properties": {
        "cosine": {
          "type": "number",
          "maximum": 1,
          "minimum": 0,
          "description": "Minimum cosine similarity to pass (default: 0.75)."
        },
        "rouge_l": {
          "type": "number",
          "maximum": 1,
          "minimum": 0,
          "description": "Minimum ROUGE-L F1 to pass (default: 0.5)."
        }
      },
      "description": "Pass/fail thresholds (defaults: cosine 0.75, rouge_l 0.5)."
    },
    "require_all": {
      "type": "boolean",
      "description": "If true (default), all cases must pass for overall PASS. If false, at least one case passing returns PASS."
    }
  }
}
run_semantic_tests output schema
{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "failed": {
      "type": "number"
    },
    "passed": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "verdict": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
run_semantic_tests annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_ci_workflow
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate a ready-to-commit GitHub Actions workflow that gates a build on IA-QA: "eval_contract" runs a .ia-eval.yaml through ia-qa-com/eval-action@v1 (needs a provider key as a repo secret), "cli_checks" runs deterministic tools via npx @ia-qa/cli and fails the build on their verdict, "selector_drift" gates E2E selectors with @ia-qa/self-healing. Deterministic template, no LLM. Returns the YAML, the secrets to create and the next steps. Pair with generate_eval_yaml for the contract.

generate_ci_workflow input schema
{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "cron": {
      "type": "string",
      "description": "For schedule (default '0 6 * * 1')."
    },
    "gate": {
      "enum": [
        "eval_contract",
        "cli_checks",
        "both",
        "selector_drift",
        "all"
      ],
      "type": "string",
      "description": "Default eval_contract. both = CLI checks + eval; all = CLI checks, drift, eval."
    },
    "provider": {
      "enum": [
        "groq",
        "openai",
        "anthropic",
        "google"
      ],
      "type": "string",
      "description": "Decides which repo secret is wired (default groq)."
    },
    "triggers": {
      "type": "array",
      "items": {
        "enum": [
          "push",
          "pull_request",
          "workflow_dispatch",
          "schedule"
        ],
        "type": "string"
      },
      "description": "Default push + pull_request."
    },
    "cli_tools": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Tools to gate on, e.g. [\"secret_scan\",\"prompt_injection_scan\"]."
    },
    "min_score": {
      "type": "number",
      "description": "Override the contract min_score (0-100)."
    },
    "app_base_url": {
      "type": "string",
      "description": "[selector_drift] Default http://127.0.0.1:3000; must match .ia-qa/config.json."
    },
    "fail_on_fail": {
      "type": "boolean",
      "description": "Default true; false reports without gating."
    },
    "node_version": {
      "type": "string",
      "description": "Default \"20\"."
    },
    "contract_path": {
      "type": "string",
      "description": "Default evals/smoke.ia-eval.yaml."
    },
    "workflow_name": {
      "type": "string"
    },
    "app_start_command": {
      "type": "string",
      "description": "[selector_drift] Boots the app, e.g. \"npm run start:ci\". Never guessed: omitted, the step is a TODO."
    }
  }
}
generate_ci_workflow output schema
{
  "type": "object",
  "properties": {
    "gate": {
      "type": "string"
    },
    "path": {
      "type": "string"
    },
    "yaml": {
      "type": "string"
    },
    "notes": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "next_steps": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "secrets_required": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}
generate_ci_workflow annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
redact_pii
Advertised by the server during the last successful anonymous check.
Advertised read-only

Automatically detect and redact Personally Identifiable Information (PII) from text. Replaces emails, phone numbers, SSNs, IBANs, credit cards, IP addresses, and JWT tokens with [REDACTED_TYPE] placeholders. Safe to use before logging or sending to an LLM.

redact_pii input schema
{
  "type": "object",
  "examples": [
    {
      "input": "order #12345678"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to redact PII from"
    },
    "types": {
      "type": "string",
      "description": "Comma-separated types to redact (default: all). Options: email, phone, ssn, iban, credit_card, ip_address, jwt"
    },
    "marker": {
      "type": "string",
      "description": "Custom replacement marker (default: \"REDACTED\"). Result: [REDACTED_EMAIL]"
    }
  }
}
redact_pii output schema
{
  "type": "object",
  "properties": {
    "clean": {
      "type": "boolean"
    },
    "pii_found": {},
    "replacements": {},
    "redacted_text": {},
    "total_redactions": {}
  },
  "additionalProperties": true
}
redact_pii annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
secret_scan
Advertised by the server during the last successful anonymous check.
Advertised read-only

Scan text or code for leaked secrets: API keys (AWS, GCP, Azure, OpenAI, Anthropic, Stripe, GitHub, GitLab, Slack, Twilio, SendGrid, HuggingFace), Slack / Teams / Discord webhook URLs, private keys, JWTs, database connection strings, Bearer and Basic auth headers, and hard-coded values assigned to password/secret/token names (a value read at run time — Cypress.env(), os.getenv() — is not flagged). Returns findings with type, severity, line and a redacted preview. Regex-based, no network.

secret_scan input schema
{
  "type": "object",
  "examples": [
    {
      "input": "redis://cache:6379"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": [
        "string",
        "array"
      ],
      "description": "Text to scan — or an array of texts / {id, text} for a batch (one result each, worst gate on top)."
    },
    "types": {
      "type": "string",
      "description": "Comma-separated families (default all): aws, gcp, azure, openai, anthropic, huggingface, github, gitlab, stripe, slack, teams, discord, cookie, twilio, sendgrid, jwt, private_key, connection_string, bearer, basic_auth, generic, or pattern names. An unknown value is rejected, never a silent \"clean\"."
    }
  }
}
secret_scan output schema
{
  "type": "object",
  "properties": {
    "summary": {
      "type": "string"
    },
    "findings": {},
    "risk_level": {},
    "input_lines": {
      "type": "number"
    },
    "scanned_types": {},
    "secrets_found": {},
    "findings_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
secret_scan annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
needle_haystack_generate
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate a "needle in a haystack" test: embeds a target fact into a large block of filler text at a specified position. Use this to test LLM context window retrieval accuracy. Returns the full haystack, the question to ask, and metadata. No API key needed.

needle_haystack_generate input schema
{
  "type": "object",
  "examples": [
    {
      "needle": "The code is 4242.",
      "tokens": 2000,
      "position": "middle",
      "question": "What is the code?"
    }
  ],
  "required": [
    "needle",
    "question"
  ],
  "properties": {
    "needle": {
      "type": "string",
      "description": "The fact to hide (e.g. \"The secret code is ALPHA-42\")"
    },
    "tokens": {
      "type": "integer",
      "default": 5000,
      "description": "Target haystack size in tokens (default: 5000, max: 100000)"
    },
    "position": {
      "enum": [
        "start",
        "middle",
        "end",
        "random"
      ],
      "type": "string",
      "default": "middle",
      "description": "Where to insert the needle: \"start\", \"middle\", \"end\", \"random\" (default: \"middle\")"
    },
    "question": {
      "type": "string",
      "description": "The question to ask the LLM (e.g. \"What is the secret code?\")"
    }
  }
}
needle_haystack_generate output schema
{
  "type": "object",
  "properties": {
    "needle": {},
    "haystack": {},
    "position": {},
    "question": {},
    "insert_block": {},
    "total_blocks": {
      "type": "number"
    },
    "estimated_tokens": {}
  },
  "additionalProperties": true
}
needle_haystack_generate annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
list_local_tests
Advertised by the server during the last successful anonymous check.
Advertised read-only

Discover .ia-eval.yaml LLM test suite files in the project directory. Scans CWD and standard sub-directories (evals/, tests/, contracts/). Returns file paths ready to pass to run_eval_contract.

list_local_tests input schema
{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "dir": {
      "type": "string",
      "description": "Directory to scan (defaults to server CWD)"
    }
  }
}
list_local_tests output schema
{
  "type": "object",
  "properties": {
    "dir": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "files": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}
list_local_tests annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_html_report
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert a run_eval_contract() LLM Test Runner JSON result into a fully self-contained dark-themed HTML report with Pass/Fail badges, side-by-side Input/Output/Ground-Truth panels, evaluator score bars, and a radar chart. Returns the HTML as a string.

generate_html_report input schema
{
  "type": "object",
  "examples": [
    {
      "results": {}
    }
  ],
  "required": [
    "results"
  ],
  "properties": {
    "results": {
      "type": "object",
      "description": "The JSON object returned by run_eval_contract()",
      "additionalProperties": true
    }
  }
}
generate_html_report output schema
{
  "type": "object",
  "properties": {
    "html": {}
  },
  "additionalProperties": true
}
generate_html_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_eval_yaml
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Generate a complete .ia-eval.yaml evaluation contract from a plain-language description of what your LLM should do. Uses Groq openai/gpt-oss-20b (server-side, no API key needed). Returns ready-to-run YAML for the LLM Test Runner (run_eval_contract). Picks appropriate evaluators (cosine_similarity, contains_check, hallucination_check, etc.) based on the task type.

generate_eval_yaml input schema
{
  "type": "object",
  "examples": [
    {
      "description": "Summarize a customer support ticket in one sentence."
    }
  ],
  "required": [
    "description"
  ],
  "properties": {
    "task_type": {
      "enum": [
        "rag",
        "summarization",
        "classification",
        "safety",
        "customer_support",
        "code_gen"
      ],
      "type": "string",
      "description": "Optional task type hint to guide evaluator selection."
    },
    "description": {
      "type": "string",
      "description": "Plain-language description of what the LLM under test should do. Be specific: describe inputs, expected behaviour, and constraints."
    },
    "system_prompt": {
      "type": "string",
      "description": "Optional system prompt of the LLM under test. Helps generate more accurate test cases."
    },
    "scenario_count": {
      "enum": [
        3,
        5,
        8
      ],
      "type": "number",
      "description": "Number of scenarios to generate (default: 5). Covers happy path + edge cases + adversarial."
    }
  }
}
generate_eval_yaml output schema
{
  "type": "object",
  "properties": {
    "yaml": {
      "type": "string"
    },
    "task_type": {
      "type": "string"
    },
    "model_used": {
      "type": "string"
    },
    "scenario_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
generate_eval_yaml annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
validate_agent_trajectory
Advertised by the server during the last successful anonymous check.
Advertised read-only

Run declarative assertions on an agent trace (OpenAI tool calls, Anthropic tool_use, LangChain run trees, ReAct logs). Deterministic, no LLM. Assertions: order (tool A before B), must_call, must_not_call, max/min calls, no_error, recovery (a successful step after the last error), no_injection, no_pii. A step is errored when the trace marks it (is_error, status error/failed, success:false) or its text starts with Error:/Traceback — prose is never keyword-scanned. Verdict PASS / FAIL / INCONCLUSIVE (0 steps parsed, never PASS).

validate_agent_trajectory input schema
{
  "type": "object",
  "examples": [
    {
      "trace": [
        {
          "role": "assistant",
          "tool_calls": [
            {
              "function": {
                "name": "search",
                "arguments": "{}"
              }
            }
          ]
        }
      ],
      "assertions": [
        {
          "tool": "search",
          "type": "must_call"
        }
      ]
    }
  ],
  "required": [
    "trace",
    "assertions"
  ],
  "properties": {
    "trace": {
      "oneOf": [
        {
          "type": "string"
        },
        {
          "type": "object",
          "additionalProperties": true
        },
        {
          "type": "array",
          "items": {}
        }
      ],
      "description": "The trace: JSON (messages array, run tree) or a Thought/Action/Observation text log."
    },
    "format": {
      "enum": [
        "auto",
        "openai",
        "langchain"
      ],
      "type": "string",
      "description": "Default auto."
    },
    "assertions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "type"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "max": {
            "type": "number",
            "description": "[max_calls]"
          },
          "min": {
            "type": "number",
            "description": "[min_calls]"
          },
          "tool": {
            "type": "string",
            "description": "For must_call, must_not_call, max_calls, min_calls."
          },
          "type": {
            "enum": [
              "order",
              "must_call",
              "must_not_call",
              "max_calls",
              "min_calls",
              "no_error",
              "recovery",
              "no_injection",
              "no_pii"
            ],
            "type": "string",
            "description": "no_injection scans tool results (indirect injection); no_pii scans the final answer. Both report types and counts, never values."
          },
          "after": {
            "type": "string",
            "description": "[order] Called after."
          },
          "types": {
            "type": "string",
            "description": "[no_pii] Comma-separated: email, phone, ssn, credit_card, ip_address, jwt. Default all."
          },
          "where": {
            "enum": [
              "tool_results",
              "answer"
            ],
            "type": "string",
            "description": "[no_injection, no_pii] Override what is scanned."
          },
          "before": {
            "type": "string",
            "description": "[order] Called first."
          },
          "sensitivity": {
            "enum": [
              "low",
              "medium",
              "high"
            ],
            "type": "string",
            "description": "[no_injection] Default low (critical patterns only); higher also fires on ordinary text."
          }
        }
      },
      "maxItems": 30
    }
  }
}
validate_agent_trajectory output schema
{
  "type": "object",
  "properties": {
    "steps": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "summary": {
      "type": "object",
      "additionalProperties": true
    },
    "verdict": {
      "type": "string"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}
validate_agent_trajectory annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
metamorphic_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Reference-free stability check: does an assistant's answer stay the same when the QUESTION is transformed (case, typo, paraphrase, reorder, translation)? You bring the outputs; no model is called (tfidf mode is deterministic and free). Default thresholds: case .95, typo .90, paraphrase .80, reorder .80, translation .75 (embeddings only), specialization .60 (advisory, never gated). Returns PASS / FAIL / INVALID — INVALID when the BASE answer is a refusal or too short, so a model that refuses everything never scores 1.0. Pair with run_semantic_tests for correctness.

metamorphic_check input schema
{
  "type": "object",
  "examples": [
    {
      "base": {
        "output": "Paris is the capital and largest city of France."
      },
      "variants": [
        {
          "output": "Paris is the capital and largest city of France.",
          "relation": "case"
        }
      ]
    }
  ],
  "required": [
    "base",
    "variants"
  ],
  "properties": {
    "base": {
      "type": "object",
      "properties": {
        "output": {
          "type": "string",
          "description": "The answer to the original question."
        },
        "question": {
          "type": "string",
          "description": "Optional, echoed back."
        }
      },
      "description": "The original run."
    },
    "mode": {
      "enum": [
        "tfidf",
        "embeddings"
      ],
      "type": "string",
      "description": "tfidf (default, lexical: gate on case/typo, read paraphrase as a trend) or embeddings (OpenAI, needs api_key; required for translation)."
    },
    "api_key": {
      "type": "string",
      "description": "OpenAI key, embeddings mode only."
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "relation",
          "output"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "output": {
            "type": "string",
            "description": "The answer to the transformed question."
          },
          "question": {
            "type": "string",
            "description": "Optional, echoed back."
          },
          "relation": {
            "enum": [
              "case",
              "typo",
              "paraphrase",
              "reorder",
              "translation",
              "specialization"
            ],
            "type": "string",
            "description": "Transformation applied to the question; sets the metric and threshold."
          }
        }
      },
      "maxItems": 20,
      "description": "Answers to transformed versions of the question."
    },
    "thresholds": {
      "type": "object",
      "properties": {
        "case": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        "typo": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        "reorder": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        "paraphrase": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        "translation": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        },
        "specialization": {
          "type": "number",
          "maximum": 1,
          "minimum": 0
        }
      },
      "description": "Per-relation overrides, 0-1. Calibrate on your own data before gating."
    },
    "require_all": {
      "type": "boolean",
      "description": "Default true: every gated variant must pass. Keep it for a gate — false lets one easy typo row hold the run at PASS while a paraphrase fails."
    },
    "baseline_guard": {
      "type": "object",
      "properties": {
        "min_length": {
          "type": "number",
          "description": "Default 40 chars."
        },
        "must_not_match": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Refusal patterns, checked in the first 200 chars. Replaces the default FR+EN list; [] disables."
        }
      },
      "description": "Floor on the BASE answer; failing it returns INVALID."
    }
  }
}
metamorphic_check output schema
{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string"
    },
    "summary": {
      "type": "object"
    },
    "verdict": {
      "type": "string"
    },
    "weakest": {
      "type": "object"
    },
    "baseline": {
      "type": "object"
    },
    "variants": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "thresholds": {
      "type": "object"
    }
  },
  "additionalProperties": true
}
metamorphic_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
test_skill
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Test a SKILL.md (Agent Skills format). (1) lint: the spec's frontmatter rules, no model — an error returns BLOCK; gate on lint.valid. (2) triggering: a model sees only the names + descriptions of this skill and its neighbours and picks which to load (temperature 0); trigger_accuracy PASS ≥80, FIX ≥50, else BLOCK. Your own scenarios give a reproducible gate; generated ones are a signal. Unanswered requests make the run INCONCLUSIVE; so do scenarios left when a call reaches its 22 s budget (split long runs). Default model: Groq on the server key.

test_skill input schema
{
  "type": "object",
  "examples": [
    {
      "skill_md": "---\nname: json-formatter\ndescription: Pretty-print a JSON string the user pastes.\n---\nFormat the JSON with 2-space indentation."
    }
  ],
  "required": [
    "skill_md"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "e.g. gpt-4o-mini. Default openai/gpt-oss-20b (Groq, server key)."
    },
    "api_key": {
      "type": "string",
      "description": "Key for the chosen model's provider; not needed for the default."
    },
    "dir_name": {
      "type": "string",
      "description": "Folder holding the SKILL.md; name must match it."
    },
    "skill_md": {
      "type": "string",
      "description": "Full content of the SKILL.md file to test, YAML frontmatter included."
    },
    "lint_only": {
      "type": "boolean",
      "description": "Format check only: no model, no key. The CI gate for a SKILL.md."
    },
    "scenarios": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "prompt",
          "should_trigger"
        ],
        "properties": {
          "prompt": {
            "type": "string"
          },
          "should_trigger": {
            "type": "boolean"
          }
        }
      },
      "description": "Fixed requests, near misses included (should_trigger false). Max 20."
    },
    "other_skills": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name",
          "description"
        ],
        "properties": {
          "name": {
            "type": "string"
          },
          "description": {
            "type": "string"
          }
        }
      },
      "description": "The skills installed next to this one. Default: six generic built-ins."
    },
    "scenario_count": {
      "enum": [
        4,
        6,
        8,
        10
      ],
      "type": "number",
      "description": "Requests to generate when scenarios is omitted (default 6)."
    }
  }
}
test_skill output schema
{
  "type": "object",
  "properties": {
    "lint": {
      "type": "object"
    },
    "score": {
      "type": "number"
    },
    "verdict": {
      "type": "string"
    },
    "scenarios": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "step_adherence": {
      "type": "number"
    },
    "scenarios_source": {
      "type": "string"
    },
    "trigger_accuracy": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
test_skill annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
diff_text
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute a unified line-by-line diff between two text strings (LCS algorithm). Returns added/removed/unchanged line counts and formatted diff hunks with configurable context lines (0–20). Use to compare versions of prompts, configs, code snippets, or any text where you need to see exactly what changed.

diff_text input schema
{
  "type": "object",
  "examples": [
    {
      "a": "a\nb\nc",
      "b": "a\nB\nc"
    }
  ],
  "required": [
    "a",
    "b"
  ],
  "properties": {
    "a": {
      "type": "string",
      "description": "Original (before) text"
    },
    "b": {
      "type": "string",
      "description": "Modified (after) text"
    },
    "context": {
      "type": "number",
      "description": "Context lines around each change (0–20, default: 3)"
    }
  }
}
diff_text output schema
{
  "type": "object",
  "properties": {
    "diff": {
      "type": "string"
    },
    "added": {
      "type": "number"
    },
    "removed": {
      "type": "number"
    },
    "unchanged": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
diff_text annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
validate_mcp_response
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate that an MCP tool response conforms to expected format, schema, and content rules. Use this to QA-test any MCP server tool. Supply the tool's actual JSON result and a set of checks to perform.

validate_mcp_response input schema
{
  "type": "object",
  "examples": [
    {
      "response": "{\"user\":{\"name\":\"x\"}}",
      "forbidden_keys": "password"
    }
  ],
  "required": [
    "response"
  ],
  "properties": {
    "response": {
      "type": "string",
      "description": "The MCP tool result as a JSON string to validate"
    },
    "min_items": {
      "type": "number",
      "description": "If response is an array, minimum number of items expected"
    },
    "expected_type": {
      "enum": [
        "object",
        "array",
        "string",
        "number"
      ],
      "type": "string",
      "description": "Expected top-level type: \"object\", \"array\", \"string\", \"number\""
    },
    "required_keys": {
      "type": "string",
      "description": "Comma-separated list of keys that MUST exist in the response (dot-notation for nested: \"data.id, data.name\")"
    },
    "actual_latency": {
      "type": "number",
      "description": "Actual measured latency in ms (from the call)"
    },
    "forbidden_keys": {
      "type": "string",
      "description": "Comma-separated list of keys that MUST NOT exist (e.g. \"password, secret, token\")"
    },
    "max_size_bytes": {
      "type": "number",
      "description": "Maximum acceptable response size in bytes"
    },
    "max_response_ms": {
      "type": "number",
      "description": "Maximum acceptable latency in ms (will be compared if provided)"
    }
  }
}
validate_mcp_response output schema
{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "checks": {},
    "failed": {
      "type": "number"
    },
    "passed": {
      "type": "number"
    },
    "verdict": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
validate_mcp_response annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
llm_output_validator
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate an LLM response against QA criteria: format checks (JSON, code, markdown), content rules (must-include, must-not-include), length constraints, language detection, and safety patterns. Essential for QA testing LLM-powered features.

llm_output_validator input schema
{
  "type": "object",
  "examples": [
    {
      "output": "{\"a\":1}",
      "must_include": "a",
      "expected_format": "json",
      "must_not_include": "TODO"
    }
  ],
  "required": [
    "output"
  ],
  "properties": {
    "output": {
      "type": "string",
      "description": "The LLM output text to validate"
    },
    "max_length": {
      "type": "number",
      "description": "Maximum character length for the output"
    },
    "min_length": {
      "type": "number",
      "description": "Minimum character length for the output"
    },
    "check_safety": {
      "type": "boolean",
      "description": "Check for PII patterns (emails, phones, SSN), profanity signals, and prompt leakage"
    },
    "must_include": {
      "type": "string",
      "description": "Comma-separated strings that MUST appear in the output"
    },
    "expected_format": {
      "enum": [
        "json",
        "markdown",
        "code",
        "plain",
        "any"
      ],
      "type": "string",
      "description": "Expected output format"
    },
    "must_not_include": {
      "type": "string",
      "description": "Comma-separated strings that must NOT appear (e.g. \"TODO, FIXME, undefined, NaN\")"
    },
    "check_json_schema": {
      "type": "string",
      "description": "If expected_format is JSON, provide required keys as comma-separated list to validate the structure"
    },
    "expected_language": {
      "type": "string",
      "description": "Expected language of the output (en, fr, es, de…). Checks for common words."
    }
  }
}
llm_output_validator output schema
{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "checks": {},
    "failed": {},
    "passed": {},
    "verdict": {}
  },
  "additionalProperties": true
}
llm_output_validator annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
compare_responses
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compare two ALREADY-PRODUCED outputs (e.g. model A vs model B on the same task) side by side. Returns deterministic metrics (token cosine, ROUGE-L, Jaccard, length/structure deltas, JSON diff) and a verdict. If a `reference` (ground truth) is given, scores each output against it and picks the closer one. If `model` + `api_key` are given, an LLM judge also picks a qualitative winner for the task. No re-execution — you bring the outputs.

compare_responses input schema
{
  "type": "object",
  "examples": [
    {
      "response_a": "Paris is the capital.",
      "response_b": "Paris is the capital."
    }
  ],
  "required": [
    "response_a",
    "response_b"
  ],
  "properties": {
    "task": {
      "type": "string",
      "description": "The task/prompt both outputs were answering — used by the LLM judge for context"
    },
    "model": {
      "type": "string",
      "description": "Optional judge model id (BYOK). When set with api_key, an LLM judge picks a qualitative winner."
    },
    "api_key": {
      "type": "string",
      "description": "Optional API key for the judge model (BYOK). Used only for the judge call; never stored."
    },
    "label_a": {
      "type": "string",
      "description": "Label for output A (e.g. \"GPT-4o\", \"v1.0\")"
    },
    "label_b": {
      "type": "string",
      "description": "Label for output B (e.g. \"GPT-5-nano\", \"v1.1\")"
    },
    "reference": {
      "type": "string",
      "description": "Optional ground-truth / expected answer. If set, each output is scored against it and the closer one wins (deterministic)."
    },
    "check_json": {
      "type": "boolean",
      "description": "Try to parse as JSON and compare structurally (keys, types, values)"
    },
    "response_a": {
      "type": "string",
      "description": "First output (e.g. model A's answer)"
    },
    "response_b": {
      "type": "string",
      "description": "Second output (e.g. model B's answer)"
    }
  }
}
compare_responses output schema
{
  "type": "object",
  "properties": {
    "judge": {},
    "labelA": {},
    "labelB": {},
    "metrics": {},
    "summary": {
      "type": "string"
    },
    "verdict": {}
  },
  "additionalProperties": true
}
compare_responses annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
analyze_responses
Advertised by the server during the last successful anonymous check.
Advertised read-only

Semantically analyze N already-produced model outputs for the SAME task (the MCP counterpart to the LLM Sandbox). Without a reference: computes consensus — pairwise cosine agreement, the most-representative output, and the outlier. With a `reference` (ground truth): also ranks every output by closeness (token cosine + ROUGE-L composite) and names the closest. No LLM, no key, runs locally. The reference mode is gate-able in CI; the consensus/outlier mode is a signal (no reference to fail against). You bring the outputs (2+). For a 2-way head-to-head with structural JSON diff use compare_responses instead.

analyze_responses input schema
{
  "type": "object",
  "examples": [
    {
      "reference": "Paris is the capital of France.",
      "responses": [
        {
          "text": "Lyon is the capital.",
          "label": "A"
        },
        {
          "text": "Paris is the capital of France.",
          "label": "B"
        }
      ]
    }
  ],
  "required": [
    "responses"
  ],
  "properties": {
    "reference": {
      "type": "string",
      "description": "Optional ground-truth answer. If set, each output is also ranked by closeness to it and the closest one is named."
    },
    "responses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "text"
        ],
        "properties": {
          "text": {
            "type": "string",
            "description": "The produced output"
          },
          "label": {
            "type": "string",
            "description": "Human name for this candidate (e.g. model id)"
          }
        }
      },
      "minItems": 2,
      "description": "The outputs to analyze (same task, N models/prompts/versions). Each item is a plain string or { \"label\": \"GPT-4o\", \"text\": \"...\" }. At least 2 required."
    }
  }
}
analyze_responses output schema
{
  "type": "object",
  "properties": {
    "count": {},
    "summary": {
      "type": "string"
    },
    "consensus": {},
    "reference_ranking": {}
  },
  "additionalProperties": true
}
analyze_responses annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
prompt_test_suite
Advertised by the server during the last successful anonymous check.
Advertised read-only

Define a test suite for a prompt: provide the system prompt, user prompt, and expected output criteria. Returns a test plan with scored rubric — use this as input for manual or automated LLM evaluation.

prompt_test_suite input schema
{
  "type": "object",
  "examples": [
    {
      "user_prompt": "Say hi",
      "system_prompt": "You are a helpful assistant."
    }
  ],
  "required": [
    "system_prompt",
    "user_prompt"
  ],
  "properties": {
    "max_tokens": {
      "type": "number",
      "description": "Max token budget for the test"
    },
    "temperature": {
      "type": "number",
      "description": "Temperature to use"
    },
    "user_prompt": {
      "type": "string",
      "description": "The user prompt to send"
    },
    "check_safety": {
      "type": "boolean",
      "description": "Include safety/PII checks in the rubric"
    },
    "must_include": {
      "type": "string",
      "description": "Required content (comma-separated)"
    },
    "system_prompt": {
      "type": "string",
      "description": "The system prompt under test"
    },
    "expected_format": {
      "enum": [
        "json",
        "markdown",
        "code",
        "plain",
        "any"
      ],
      "type": "string",
      "description": "Expected output format"
    },
    "must_not_include": {
      "type": "string",
      "description": "Forbidden content (comma-separated)"
    },
    "expected_behavior": {
      "type": "string",
      "description": "Description of what the LLM should do (free text)"
    },
    "adversarial_prompts": {
      "type": "boolean",
      "description": "Auto-generate adversarial test variants (jailbreak, injection, edge cases)"
    }
  }
}
prompt_test_suite output schema
{
  "type": "object",
  "properties": {
    "rubric": {},
    "categories": {
      "type": "array"
    },
    "total_tests": {
      "type": "number"
    },
    "instructions": {
      "type": "string"
    },
    "test_suite_name": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
prompt_test_suite annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
mcp_server_health_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Check an MCP server's tool definitions without contacting it — for a server not deployed yet, a stdio server, or a CI gate. Paste the answer to tools/list (raw JSON-RPC or its result), a bare array of tools, one tool definition, or a manifest carrying name/description; input_shape says which one was read. Validates every tool against the MCP spec (name 1-128 chars of A-Z a-z 0-9 _ - .; camelCase and a tool with no parameters are valid; inputSchema of type object; required fields listed in properties) and, with strict, documentation (description ≥ 20 chars, every parameter with a description and a type). verdict: FAIL when a tool breaks a rule or no tool is found, WARN when only a manifest's server name/description is missing, PASS otherwise. A tools/list carries no server name, so those two checks are not scored on it (the name comes from initialize). Gate on verdict or on checks[tool_quality].pass.

mcp_server_health_check input schema
{
  "type": "object",
  "examples": [
    {
      "manifest": "{\"tools\":[{\"name\":\"get_weather\",\"description\":\"Return the current weather for a city. Use it when the user asks about the weather now.\",\"inputSchema\":{\"type\":\"object\",\"required\":[\"city\"],\"properties\":{\"city\":{\"type\":\"string\",\"description\":\"City name, e.g. Paris\"}}}}]}"
    }
  ],
  "required": [
    "manifest"
  ],
  "properties": {
    "strict": {
      "type": "boolean",
      "description": "Also require documentation: every description ≥ 20 characters, every parameter with a description and a type."
    },
    "manifest": {
      "type": "string",
      "description": "JSON text: the answer to tools/list (raw JSON-RPC or its result), an array of tools, one tool definition, or a manifest with name/description/tools."
    }
  }
}
mcp_server_health_check output schema
{
  "type": "object",
  "properties": {
    "stats": {
      "type": "object"
    },
    "total": {
      "type": "number"
    },
    "checks": {
      "type": "array"
    },
    "failed": {
      "type": "number"
    },
    "passed": {
      "type": "number"
    },
    "verdict": {
      "type": "string"
    },
    "toolIssues": {},
    "input_shape": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
mcp_server_health_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
mcp_server_evaluate
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Check that a live MCP server over Streamable HTTP speaks the protocol, 2026-07-28 or earlier: handshake or server/discover, tools/list and its definitions, error codes, one tools/call, structuredContent against outputSchema, latency. Returns PASS/FIX/BLOCK with a 0-100 score, or INCONCLUSIVE (score null) when authorization is required. The verdict covers the PROTOCOL, never whether tools answer correctly: what_this_does_not_prove lists what was not measured. Called: only test_tool_name, or a tool annotated readOnlyHint: true. A refusal of invented arguments is not scored (tool_behaviour: refused_placeholder); pass test_tool_args to exercise the tool. Private addresses and stdio are out of reach: paste tools/list into mcp_server_health_check.

mcp_server_evaluate input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ia-qa.com/mcp"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Public URL of the MCP endpoint (e.g. https://mcp.example.com/mcp). An origin alone (https://www.ia-qa.com) tries /mcp, then /."
    },
    "test_tool_args": {
      "type": "object",
      "description": "Real arguments, sent to the tested server. Without them, required ones are invented.",
      "additionalProperties": true
    },
    "test_tool_name": {
      "type": "string",
      "description": "Tool to call. Default: a read-only one, preferring no required arg."
    }
  }
}
mcp_server_evaluate output schema
{
  "type": "object",
  "properties": {
    "scope": {
      "type": "string"
    },
    "score": {
      "type": [
        "number",
        "null"
      ]
    },
    "checks": {
      "type": "array"
    },
    "server": {
      "type": "object"
    },
    "latency": {
      "type": [
        "object",
        "null"
      ]
    },
    "verdict": {
      "type": "string"
    },
    "endpoint": {
      "type": "string"
    },
    "next_steps": {
      "type": "array"
    },
    "tool_behaviour": {
      "type": "string"
    },
    "what_this_proves": {
      "type": "array"
    },
    "what_this_does_not_prove": {
      "type": "array"
    }
  },
  "additionalProperties": true
}
mcp_server_evaluate annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
llm_format_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate that an LLM output matches an expected format: JSON, Markdown, code block, bullet list, numbered list, table, YAML, XML, or custom regex. Essential for structured output testing.

llm_format_check input schema
{
  "type": "object",
  "examples": [
    {
      "output": "a: 1\nb: [1, 2]",
      "expected_format": "yaml"
    }
  ],
  "required": [
    "output",
    "expected_format"
  ],
  "properties": {
    "output": {
      "type": "string",
      "description": "The LLM output to validate"
    },
    "regex_pattern": {
      "type": "string",
      "description": "Custom regex pattern (only when expected_format is \"regex\")"
    },
    "expected_format": {
      "enum": [
        "json",
        "markdown_heading",
        "code_block",
        "bullet_list",
        "numbered_list",
        "table",
        "yaml",
        "xml",
        "regex"
      ],
      "type": "string",
      "description": "Expected format"
    }
  }
}
llm_format_check output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "checks": {},
    "failed": {},
    "passed": {},
    "total_checks": {
      "type": "number"
    },
    "expected_format": {}
  },
  "additionalProperties": true
}
llm_format_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
consistency_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compare multiple LLM responses to the same prompt and detect inconsistencies using Jaccard word-overlap similarity and fact drift (number comparison). Fast, deterministic, no API key needed. Limitations: relies on surface-level word matching — "Paris is the capital of France" vs "Paris is the French capital" may score low despite semantic equivalence. For true semantic consistency, use run_semantic_tests with embedding mode. Essential for determinism testing.

consistency_check input schema
{
  "type": "object",
  "examples": [
    {
      "responses": [
        "The capital of France is Paris.",
        "Paris is the capital of France."
      ]
    }
  ],
  "required": [
    "responses"
  ],
  "properties": {
    "responses": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2+ LLM responses to compare (same prompt, different runs)"
    },
    "check_facts": {
      "type": "boolean",
      "description": "Check for contradictory numbers/facts across responses (default: true)"
    }
  }
}
consistency_check output schema
{
  "type": "object",
  "properties": {
    "verdict": {},
    "fact_drift": {},
    "avg_similarity": {},
    "response_count": {
      "type": "number"
    },
    "pairwise_scores": {},
    "fact_contradiction": {},
    "length_variance_percent": {}
  },
  "additionalProperties": true
}
consistency_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
llm_json_schema_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate that an LLM JSON output matches a JSON Schema definition. Tests required fields, types, enums, nested objects, and arrays. Critical for function-calling and structured output testing.

llm_json_schema_check input schema
{
  "type": "object",
  "examples": [
    {
      "output": "{\"name\":\"a\",\"age\":3}",
      "schema": {
        "type": "object",
        "required": [
          "name",
          "age"
        ],
        "properties": {
          "age": {
            "type": "integer",
            "minimum": 0
          },
          "name": {
            "type": "string"
          },
          "role": {
            "enum": [
              "admin",
              "user"
            ]
          }
        }
      }
    }
  ],
  "required": [
    "output",
    "schema"
  ],
  "properties": {
    "output": {
      "type": "string",
      "description": "The LLM JSON output (raw string, will be parsed)"
    },
    "schema": {
      "type": "object",
      "description": "JSON Schema (draft-07 subset) to validate against",
      "additionalProperties": true
    }
  }
}
llm_json_schema_check output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "errors": {
      "type": "array"
    },
    "error_count": {
      "type": "number"
    },
    "parse_error": {},
    "parsed_type": {}
  },
  "additionalProperties": true
}
llm_json_schema_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
response_quality_score
Advertised by the server during the last successful anonymous check.
Advertised read-only

Score an LLM response against the criteria you pass: coverage of expected_keywords and compliance with max_length. Returns a 0-100 score over the criteria actually measured — or total_score null with the reason when none is given, because relevance and correctness cannot be read off word overlap (a correct one-word answer shares no words with its question). For meaning against a reference answer, use run_semantic_tests. Also returns unscored signals: question-term overlap, average sentence length, markdown.

response_quality_score input schema
{
  "type": "object",
  "examples": [
    {
      "question": "q",
      "response": "anything"
    }
  ],
  "required": [
    "question",
    "response"
  ],
  "properties": {
    "question": {
      "type": "string",
      "description": "The original question/prompt"
    },
    "response": {
      "type": "string",
      "description": "The LLM response to score"
    },
    "max_length": {
      "type": "number",
      "description": "Maximum character length. Scored as a proportional penalty beyond it."
    },
    "expected_keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Keywords a correct answer must contain, as whole words (case-insensitive; a plural in -s/-es counts). Scored as coverage."
    }
  }
}
response_quality_score output schema
{
  "type": "object",
  "properties": {
    "grade": {},
    "stats": {
      "type": "object"
    },
    "reason": {
      "type": "string"
    },
    "signals": {
      "type": "object"
    },
    "breakdown": {
      "type": "object"
    },
    "max_score": {
      "type": "number"
    },
    "total_score": {},
    "not_measured": {
      "type": "array"
    }
  },
  "additionalProperties": true
}
response_quality_score annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
toxicity_scan
Advertised by the server during the last successful anonymous check.
Advertised read-only

Scan text for toxic language, hate speech, bias/stereotype framing, violence, sexual and self-harm content. Lexical + structural pattern matching (identity term + predicate), not a semantic classifier — returns per-category risk plus the named rules that fired, so every finding can be checked. Languages: English for every category; French for insults, coarse language, direct threats and self-harm intent; anything else reads clean, so clean is not proof of safety. Text is also matched after undoing leetspeak and lookalike letters. Self-harm is critical only on a first-person intent — a mention ("call 988 if you have suicidal thoughts") is medium. Useful for LLM safety guardrail testing and triage; signal-only, not a calibrated CI gate.

toxicity_scan input schema
{
  "type": "object",
  "examples": [
    {
      "text": "Ce contrat est conclu avec un partenaire."
    }
  ],
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "Text to scan"
    },
    "categories": {
      "type": "array",
      "items": {
        "enum": [
          "profanity",
          "hate_speech",
          "violence",
          "sexual",
          "self_harm",
          "bias"
        ],
        "type": "string"
      },
      "description": "Categories to check (default: all)"
    }
  }
}
toxicity_scan output schema
{
  "type": "object",
  "properties": {
    "method": {
      "type": "string"
    },
    "results": {},
    "text_length": {
      "type": "number"
    },
    "overall_risk": {},
    "categories_checked": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
toxicity_scan annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
function_call_validate
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate an LLM function call / tool_use output: check that function name is in allowed list, arguments match expected schema (types, enums, ranges), no extra/missing args. Reads the definitions as OpenAI (`parameters`), MCP (`inputSchema`) or Anthropic (`input_schema`) write them, or as plain `required_args`/`optional_args`; reads the call as `arguments` (object or JSON string), `input` (Anthropic tool_use) or an OpenAI `{function:{…}}` wrapper.

function_call_validate input schema
{
  "type": "object",
  "examples": [
    {
      "function_call": {
        "name": "get_weather",
        "arguments": {
          "city": "Paris"
        }
      },
      "allowed_functions": [
        {
          "name": "get_weather",
          "required_args": [
            "city"
          ]
        }
      ]
    }
  ],
  "required": [
    "function_call",
    "allowed_functions"
  ],
  "properties": {
    "function_call": {
      "type": "object",
      "description": "The function call object from LLM (e.g. { \"name\": \"get_weather\", \"arguments\": {\"city\":\"Paris\"} })",
      "additionalProperties": true
    },
    "allowed_functions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "name": {
            "type": "string"
          },
          "parameters": {
            "type": "object",
            "description": "OpenAI form: a JSON Schema of the arguments",
            "additionalProperties": true
          },
          "inputSchema": {
            "type": "object",
            "description": "MCP form",
            "additionalProperties": true
          },
          "input_schema": {
            "type": "object",
            "description": "Anthropic form",
            "additionalProperties": true
          },
          "optional_args": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "required_args": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "description": "List of allowed function definitions, in OpenAI, MCP or Anthropic form, or as {name, required_args, optional_args}"
    }
  }
}
function_call_validate output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "errors": {
      "type": "array"
    },
    "error_count": {
      "type": "number"
    },
    "function_name": {},
    "provided_args": {},
    "required_args": {}
  },
  "additionalProperties": true
}
function_call_validate annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
conversation_analyze
Advertised by the server during the last successful anonymous check.
Advertised read-only

Analyze a multi-turn conversation for context retention, topic drift, instruction following, and repetition. Accepts messages array [{role, content}]. Essential for chatbot QA.

conversation_analyze input schema
{
  "type": "object",
  "examples": [
    {
      "messages": [
        {
          "role": "user",
          "content": "What is your refund policy?"
        },
        {
          "role": "assistant",
          "content": "Refunds are available within 30 days."
        }
      ]
    }
  ],
  "required": [
    "messages"
  ],
  "properties": {
    "messages": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "enum": [
              "system",
              "user",
              "assistant"
            ],
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "description": "Conversation messages in order"
    }
  }
}
conversation_analyze output schema
{
  "type": "object",
  "properties": {
    "turn_count": {
      "type": "number"
    },
    "repetitions": {},
    "topic_drift": {},
    "user_messages": {
      "type": "number"
    },
    "context_retention": {},
    "has_system_prompt": {
      "type": "boolean"
    },
    "assistant_messages": {
      "type": "number"
    },
    "avg_response_length": {
      "type": "number"
    },
    "repetition_detected": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
conversation_analyze annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
mcp_schema_lint
Advertised by the server during the last successful anonymous check.
Advertised read-only

Lint one MCP tool definition with the same rules as mcp_server_health_check: errors break the MCP spec (FAIL), documentation_issues are what its strict mode refuses — a parameter without description or type (FIX, never an A) — and suggestions are style only (snake_case) and change nothing.

mcp_schema_lint input schema
{
  "type": "object",
  "examples": [
    {
      "tool_definition": {
        "name": "get_weather",
        "description": "Return the current weather for a city. Use it when the user asks about the weather now.",
        "inputSchema": {
          "type": "object",
          "required": [
            "city"
          ],
          "properties": {
            "city": {
              "type": "string",
              "description": "City name, e.g. Paris"
            }
          }
        }
      }
    }
  ],
  "required": [
    "tool_definition"
  ],
  "properties": {
    "tool_definition": {
      "type": "object",
      "description": "MCP tool definition object with name, description, inputSchema",
      "additionalProperties": true
    }
  }
}
mcp_schema_lint output schema
{
  "type": "object",
  "properties": {
    "grade": {},
    "errors": {},
    "warnings": {},
    "error_count": {
      "type": "number"
    },
    "quality_score": {},
    "warning_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
mcp_schema_lint annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
cot_analyzer
Advertised by the server during the last successful anonymous check.
Advertised read-only

Analyze a Chain-of-Thought (CoT) or reasoning trace from an LLM. Detects step count, logical flow, conclusion presence, backtracking, and estimates reasoning depth. Useful for o1/o3/DeepSeek-R1 evaluation.

cot_analyzer input schema
{
  "type": "object",
  "examples": [
    {
      "reasoning": "Step 1: 12 apples minus 5 eaten.\nStep 2: 12 - 5 = 7.\nTherefore, the answer is 7.",
      "expected_conclusion": "7"
    }
  ],
  "required": [
    "reasoning"
  ],
  "properties": {
    "reasoning": {
      "type": "string",
      "description": "The CoT / reasoning trace text (e.g. from <think> tags or step-by-step output)"
    },
    "expected_conclusion": {
      "type": "string",
      "description": "Expected final answer to check against (optional)"
    }
  }
}
cot_analyzer output schema
{
  "type": "object",
  "properties": {
    "markers": {},
    "step_count": {
      "type": "number"
    },
    "total_chars": {
      "type": "number"
    },
    "total_lines": {
      "type": "number"
    },
    "has_conclusion": {
      "type": "boolean"
    },
    "reasoning_depth": {},
    "backtracking_signals": {},
    "reasoning_depth_label": {},
    "conclusion_matches_expected": {}
  },
  "additionalProperties": true
}
cot_analyzer annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
ab_test_report
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate an A/B test report comparing two prompts or model configurations. Accepts arrays of scores and returns mean, median, std deviation, improvement percentage, and a Welch t-test at 95 %: `winner` names a variant only when the difference is significant — otherwise "no_significant_difference", or "insufficient_samples" under 2 scores per variant.

ab_test_report input schema
{
  "type": "object",
  "examples": [
    {
      "variant_a": {
        "name": "A",
        "scores": [
          70,
          71,
          69
        ]
      },
      "variant_b": {
        "name": "B",
        "scores": [
          70,
          71,
          69
        ]
      }
    }
  ],
  "required": [
    "variant_a",
    "variant_b"
  ],
  "properties": {
    "variant_a": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name/label for variant A"
        },
        "scores": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of scores (0-100)"
        }
      },
      "description": "First variant configuration with name and score array"
    },
    "variant_b": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "description": "Name/label for variant B"
        },
        "scores": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "description": "Array of scores (0-100)"
        }
      },
      "description": "Second variant configuration with name and score array"
    }
  }
}
ab_test_report output schema
{
  "type": "object",
  "properties": {
    "max": {},
    "min": {},
    "mean": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "median": {
      "type": "string"
    },
    "winner": {},
    "std_dev": {
      "type": "string"
    },
    "variant_a": {
      "type": "object"
    },
    "variant_b": {
      "type": "object"
    },
    "recommendation": {
      "type": "number"
    },
    "improvement_percent": {}
  },
  "additionalProperties": true
}
ab_test_report annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
similarity_score
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute text similarity between reference and hypothesis using multiple metrics: Cosine (BoW, TF-IDF), Jaccard, ROUGE-1, ROUGE-2, ROUGE-L, and BLEU. No API key needed. Ideal for LLM eval (expected vs actual), RAG quality checks, and NLG benchmarking. Supports batch mode.

similarity_score input schema
{
  "type": "object",
  "examples": [
    {
      "reference": "the cat sat on the mat",
      "threshold": 0.5,
      "hypothesis": "the cat sat on the mat"
    }
  ],
  "properties": {
    "batch": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "reference",
          "hypothesis"
        ],
        "properties": {
          "reference": {
            "type": "string"
          },
          "hypothesis": {
            "type": "string"
          }
        }
      },
      "description": "Batch mode: array of {reference, hypothesis} pairs."
    },
    "metrics": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Metrics to compute (default: all). Options: \"cosine_bow\", \"cosine_tfidf\", \"jaccard\", \"rouge1\", \"rouge2\", \"rougeL\", \"bleu\""
    },
    "reference": {
      "type": "string",
      "description": "Reference / expected text (ground truth)"
    },
    "threshold": {
      "type": "number",
      "description": "Optional pass/fail threshold (0-1). Applies to ROUGE-L F1 score."
    },
    "hypothesis": {
      "type": "string",
      "description": "Hypothesis / actual text (LLM output)"
    }
  }
}
similarity_score output schema
{
  "type": "object",
  "properties": {
    "f1": {
      "type": "number"
    },
    "mode": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "recall": {
      "type": "number"
    },
    "results": {},
    "precision": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
similarity_score annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
bias_detect
Advertised by the server during the last successful anonymous check.
Advertised read-only

Analyse a set of LLM responses generated from the same prompt template but with different demographic variants (gender, origin, age, tone). Returns a bias score (0-100), sentiment analysis per variant, pairwise Jaccard similarity, and a human-readable verdict. No API key needed — runs entirely locally.

bias_detect input schema
{
  "type": "object",
  "examples": [
    {
      "responses": [
        "He is great.",
        "She is great."
      ]
    }
  ],
  "required": [
    "responses"
  ],
  "properties": {
    "responses": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "variantId",
          "answer"
        ],
        "properties": {
          "answer": {
            "type": "string",
            "description": "The LLM response text for this variant"
          },
          "variantId": {
            "type": "string",
            "description": "Identifier for the demographic variant (e.g. \"male\", \"female\", \"western\", \"young\")"
          }
        }
      },
      "minItems": 2,
      "description": "Array of variant responses to compare for bias"
    }
  }
}
bias_detect output schema
{
  "type": "object",
  "properties": {
    "verdict": {
      "type": "string"
    },
    "lengthCV": {
      "type": "number"
    },
    "biasScore": {
      "type": "number"
    },
    "sentiments": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "ratio": {
            "type": "number"
          },
          "negative": {
            "type": "number"
          },
          "positive": {
            "type": "number"
          },
          "variantId": {
            "type": "string"
          }
        }
      }
    },
    "avgSimilarity": {
      "type": "number"
    },
    "minSimilarity": {
      "type": "number"
    },
    "sentimentVariance": {
      "type": "number"
    },
    "pairwiseSimilarities": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "a": {
            "type": "string"
          },
          "b": {
            "type": "string"
          },
          "score": {
            "type": "number"
          }
        }
      }
    }
  },
  "additionalProperties": true
}
bias_detect annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
run_vlm_test_suite
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Test a vision model (OpenAI, Anthropic or Gemini) on one image: each test case asks a question and asserts on the answer (contains, not_contains, json_format, min_length, max_length, semantic_contains = TF-IDF cosine ≥ 0.4). Returns per-case PASS/FAIL, the pass rate, an overall PASS/WARNING/FAIL against threshold, and latency. BYOK: your key for the model's provider; the image is fetched only from a public address.

run_vlm_test_suite input schema
{
  "type": "object",
  "examples": [
    {
      "model": "gemini-2.5-flash",
      "api_key": "<your-api-key>",
      "image_url": "https://www.ia-qa.com/media/discover-report-poster.png",
      "test_cases": [
        {
          "question": "Does the image contain text? Answer yes or no.",
          "assertion_type": "contains",
          "assertion_value": "yes"
        }
      ]
    }
  ],
  "required": [
    "test_cases",
    "model",
    "api_key"
  ],
  "properties": {
    "model": {
      "enum": [
        "gpt-4o",
        "gpt-4o-mini",
        "claude-sonnet-4-6",
        "claude-haiku-4-5-20251001",
        "gemini-3.5-flash",
        "gemini-2.5-flash"
      ],
      "type": "string"
    },
    "api_key": {
      "type": "string",
      "description": "Key for the model's provider."
    },
    "image_url": {
      "type": "string",
      "description": "Public image URL (or image_base64)."
    },
    "threshold": {
      "type": "number",
      "description": "Pass rate for an overall PASS (default 80)."
    },
    "test_cases": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "question"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "question": {
            "type": "string"
          },
          "assertion_type": {
            "enum": [
              "contains",
              "not_contains",
              "json_format",
              "min_length",
              "max_length",
              "semantic_contains"
            ],
            "type": "string"
          },
          "assertion_value": {
            "type": "string",
            "description": "Not needed for json_format."
          }
        }
      },
      "maxItems": 10
    },
    "image_base64": {
      "type": "string"
    },
    "system_prompt": {
      "type": "string"
    },
    "image_mime_type": {
      "type": "string",
      "description": "For image_base64 (default image/jpeg)."
    }
  }
}
run_vlm_test_suite output schema
{
  "type": "object",
  "properties": {
    "model": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "failed": {
      "type": "number"
    },
    "passed": {
      "type": "number"
    },
    "results": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "verdict": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
run_vlm_test_suite annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
multimodal_eval_guide
Advertised by the server during the last successful anonymous check.
Advertised read-only

Multimodal evaluation: action=guide (default) interprets a CLIP/FID/VQA score against reference thresholds; clip_score, fid_score, vqa_accuracy compute the metric (HuggingFace, or your VLM key for VQA); pipeline runs all three.

multimodal_eval_guide input schema
{
  "type": "object",
  "examples": [
    {
      "score": 72,
      "metric": "clip_score"
    }
  ],
  "properties": {
    "fid": {
      "type": "object",
      "description": "[pipeline] {real_images, generated_images}",
      "additionalProperties": true
    },
    "vqa": {
      "type": "object",
      "description": "[pipeline] Same inputs as vqa_accuracy.",
      "additionalProperties": true
    },
    "clip": {
      "type": "object",
      "description": "[pipeline] {image_url, text}",
      "additionalProperties": true
    },
    "text": {
      "type": "string",
      "description": "[clip_score] Text to compare with the image."
    },
    "model": {
      "type": "string",
      "description": "[vqa_accuracy] Default gpt-4o."
    },
    "score": {
      "type": "number",
      "description": "[guide] A score to interpret."
    },
    "action": {
      "enum": [
        "guide",
        "clip_score",
        "fid_score",
        "vqa_accuracy",
        "pipeline"
      ],
      "type": "string"
    },
    "metric": {
      "enum": [
        "clip_score",
        "fid",
        "vqa_accuracy",
        "all"
      ],
      "type": "string",
      "description": "[guide]"
    },
    "api_key": {
      "type": "string",
      "description": "[vqa_accuracy] Key for the model's provider."
    },
    "image_url": {
      "type": "string",
      "description": "[clip_score, vqa_accuracy] Public image URL."
    },
    "test_cases": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "question": {
            "type": "string"
          },
          "accepted_answers": {
            "type": "array",
            "items": {
              "type": "string"
            }
          }
        }
      },
      "description": "[vqa_accuracy]"
    },
    "real_images": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "[fid_score] URLs."
    },
    "image_base64": {
      "type": "string",
      "description": "[clip_score, vqa_accuracy]"
    },
    "system_prompt": {
      "type": "string",
      "description": "[vqa_accuracy]"
    },
    "image_mime_type": {
      "type": "string",
      "description": "[clip_score, vqa_accuracy]"
    },
    "generated_images": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "[fid_score] URLs."
    }
  }
}
multimodal_eval_guide output schema
{
  "type": "object",
  "properties": {
    "errors": {},
    "metrics": {},
    "results": {},
    "web_tool": {
      "type": "string"
    },
    "best_practices": {
      "type": "array"
    },
    "comparison_table": {
      "type": "array"
    },
    "score_interpretation": {}
  },
  "additionalProperties": true
}
multimodal_eval_guide annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
run_vlm_test_suite_batch
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Compare several vision models on the same image and test cases, in parallel (same assertions as run_vlm_test_suite). Returns per-model PASS/FAIL, pass rates, latency and a comparison table. BYOK: one key per model.

run_vlm_test_suite_batch input schema
{
  "type": "object",
  "examples": [
    {
      "models": [
        "gpt-4o-mini",
        "gemini-2.5-flash"
      ],
      "api_keys": {
        "gpt-4o-mini": "<your-openai-key>",
        "gemini-2.5-flash": "<your-google-key>"
      },
      "image_url": "https://www.ia-qa.com/media/discover-report-poster.png",
      "test_cases": [
        {
          "question": "Does the image contain text? Answer yes or no."
        }
      ]
    }
  ],
  "required": [
    "test_cases",
    "models",
    "api_keys"
  ],
  "properties": {
    "models": {
      "type": "array",
      "items": {
        "enum": [
          "gpt-4o",
          "gpt-4o-mini",
          "claude-sonnet-4-6",
          "claude-haiku-4-5-20251001",
          "gemini-3.5-flash",
          "gemini-2.5-flash"
        ],
        "type": "string"
      },
      "maxItems": 6,
      "minItems": 1
    },
    "api_keys": {
      "type": "object",
      "description": "Model id → API key.",
      "additionalProperties": {
        "type": "string"
      }
    },
    "image_url": {
      "type": "string",
      "description": "Public image URL (or image_base64)."
    },
    "threshold": {
      "type": "number",
      "description": "Pass rate for an overall PASS (default 80)."
    },
    "test_cases": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "question"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "question": {
            "type": "string"
          },
          "assertion_type": {
            "enum": [
              "contains",
              "not_contains",
              "json_format",
              "min_length",
              "max_length",
              "semantic_contains"
            ],
            "type": "string"
          },
          "assertion_value": {
            "type": "string",
            "description": "Not needed for json_format."
          }
        }
      },
      "maxItems": 10
    },
    "image_base64": {
      "type": "string"
    },
    "system_prompt": {
      "type": "string"
    },
    "image_mime_type": {
      "type": "string",
      "description": "For image_base64 (default image/jpeg)."
    }
  }
}
run_vlm_test_suite_batch output schema
{
  "type": "object",
  "properties": {
    "suites": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "verdict": {
      "type": "string"
    },
    "total_failed": {
      "type": "number"
    },
    "total_passed": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
run_vlm_test_suite_batch annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
shield_analyze
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

One-call safety gate for an LLM response: grounding (with source), prompt injection on the response AND the prompt (checks.injection / checks.injection_prompt), toxicity, PII, guardrail rules, quality, plus an LLM review on Groq (server key; model "none" skips it and sends nothing out). Returns PASS/FIX/BLOCK, a 0-100 safety score, per-check results and fixes. PII gates the verdict: SSN or card → BLOCK, email → FIX, phone/IP flagged only.

shield_analyze input schema
{
  "type": "object",
  "examples": [
    {
      "model": "none",
      "prompt": "When will my order arrive?",
      "response": "Your order #1234 will arrive tomorrow."
    }
  ],
  "required": [
    "response"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "LLM review model: openai/gpt-oss-20b, openai/gpt-oss-120b, qwen/qwen3.8-27b (default openai/gpt-oss-20b), or \"none\"."
    },
    "rules": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "type": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "value": {
            "type": "string"
          }
        }
      },
      "description": "Same format as guardrail_test."
    },
    "prompt": {
      "type": "string",
      "description": "The original prompt — also scanned for injection; pass it whenever you have it."
    },
    "source": {
      "type": "string",
      "description": "Reference text for the grounding check."
    },
    "response": {
      "type": "string",
      "description": "The LLM response to check."
    }
  }
}
shield_analyze output schema
{
  "type": "object",
  "properties": {
    "flags": {},
    "grade": {},
    "score": {},
    "checks": {
      "type": "object"
    },
    "verdict": {}
  },
  "additionalProperties": true
}
shield_analyze annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
security_headers_check
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Analyse the HTTP security headers of a public URL OR of raw response headers you paste in. Grades each header (A–F) for: Strict-Transport-Security, Content-Security-Policy, X-Frame-Options, X-Content-Type-Options, Referrer-Policy, Permissions-Policy, X-XSS-Protection, Cross-Origin-Opener-Policy, Cross-Origin-Resource-Policy, and Cross-Origin-Embedder-Policy. Returns an overall score (0–100), per-header grades, missing headers, and fix snippets for Express, Nginx, and Apache. For localhost/private targets the remote server cannot reach, pass the `headers` parameter instead of `url`.

security_headers_check input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ia-qa.com"
    }
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Optional. Full public URL to check (e.g. https://example.com). Omit it entirely when using `headers`. The server cannot reach localhost/private IPs."
    },
    "headers": {
      "description": "Optional, and sufficient on its own (no url needed). The response headers to grade, either as an object {\"strict-transport-security\": \"max-age=...\", ...} or as the raw header block pasted as a string (e.g. `curl -sI` output). Use this to audit a local server the remote MCP cannot reach."
    }
  }
}
security_headers_check output schema
{
  "type": "object",
  "properties": {
    "fix": {},
    "key": {},
    "url": {},
    "weak": {},
    "grade": {},
    "score": {},
    "value": {},
    "header": {},
    "source": {},
    "weight": {},
    "details": {},
    "missing": {},
    "weak_count": {
      "type": "number"
    },
    "missing_count": {
      "type": "number"
    },
    "overall_grade": {},
    "headers_checked": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
security_headers_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
ssl_certificate_check
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Analyse the SSL/TLS certificate of any HTTPS host. Returns certificate subject, issuer, validity dates, days until expiry, protocol version, cipher suite, key exchange info, and an overall grade (A+, A, B, C, F). Detects expired, self-signed, and weak certificates. Use this to audit TLS posture before production deployment or during security reviews.

ssl_certificate_check input schema
{
  "type": "object",
  "examples": [
    {
      "host": "www.ia-qa.com"
    }
  ],
  "required": [
    "host"
  ],
  "properties": {
    "host": {
      "type": "string",
      "description": "Hostname to check (e.g. example.com). Do not include https:// prefix."
    },
    "port": {
      "type": "number",
      "description": "Port number (default: 443)"
    }
  }
}
ssl_certificate_check output schema
{
  "type": "object",
  "properties": {
    "host": {
      "type": "string"
    },
    "grade": {
      "type": "string"
    },
    "cipher": {
      "type": "object"
    },
    "issuer": {
      "type": "object"
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "subject": {
      "type": "object"
    },
    "protocol": {
      "type": "string"
    },
    "valid_to": {
      "type": "string"
    },
    "is_expired": {
      "type": "boolean"
    },
    "valid_from": {
      "type": "string"
    },
    "is_self_signed": {
      "type": "boolean"
    },
    "days_until_expiry": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
ssl_certificate_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
cors_test
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Audit a URL for CORS misconfigurations across several origins: wildcard with credentials, reflected origin, null origin, subdomain bypass, missing Vary. Returns risk level (safe/low/medium/high/critical) plus per-origin results. "unknown" means nothing was tested: every origin failed to connect, answered 5xx, or was refused with no CORS header (a 404, a firewall); never read it as "safe".

cors_test input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ia-qa.com/mcp",
      "origin": "https://other.example"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL to test (e.g. https://api.example.com/endpoint)"
    },
    "origin": {
      "type": "string",
      "description": "Custom Origin header to test (default: tests multiple origins automatically)"
    }
  }
}
cors_test output schema
{
  "type": "object",
  "properties": {
    "url": {},
    "error": {
      "type": "string"
    },
    "tests": {},
    "warning": {
      "type": "string"
    },
    "risk_level": {
      "enum": [
        "safe",
        "low",
        "medium",
        "high",
        "critical",
        "unknown"
      ]
    },
    "origins_tested": {
      "type": "number"
    },
    "total_findings": {
      "type": "number"
    },
    "origins_reachable": {
      "type": "number"
    },
    "origins_conclusive": {
      "type": "number"
    },
    "origins_inconclusive": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
cors_test annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
cors_checker
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Would a browser on this origin be allowed to read this URL? Verdict allowed | blocked | unknown, the reason, and the header to add. Only GET and HEAD are really sent: other methods measure the preflight alone. To audit many origins use cors_test.

cors_checker input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ia-qa.com/mcp"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL to test, e.g. https://api.example.com/resource"
    },
    "method": {
      "type": "string",
      "description": "Method the page uses (default: GET)"
    },
    "origin": {
      "type": "string",
      "description": "Origin of the calling page (default: https://yourdomain.com)"
    },
    "credentials": {
      "type": "boolean",
      "description": "True for fetch with credentials: \"include\""
    },
    "request_headers": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Headers the page sets, e.g. [\"Authorization\", \"Content-Type: application/json\"]. Names only are sent."
    }
  }
}
cors_checker output schema
{
  "type": "object",
  "properties": {
    "fix": {},
    "checks": {},
    "reason": {},
    "status": {},
    "verdict": {
      "enum": [
        "allowed",
        "blocked",
        "unknown"
      ],
      "type": "string"
    },
    "preflight": {},
    "corsHeaders": {},
    "request_sent": {}
  },
  "additionalProperties": true
}
cors_checker annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
cookie_security_audit
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Audit the security attributes of cookies set by any URL. Fetches the URL and inspects all Set-Cookie headers for: HttpOnly, Secure, SameSite, Domain scope, Path scope, Max-Age/Expires, __Host-/__Secure- prefixes. Flags insecure patterns: missing HttpOnly on session cookies, missing Secure flag, SameSite=None without Secure, overly broad Domain, and excessive TTL. Returns per-cookie grades and an overall security score (0–100) — the score is the WEAKEST cookie, not the average, so one leaking session cookie cannot be averaged into a green result (average_score is reported separately).

cookie_security_audit input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ia-qa.com"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL to audit (e.g. https://example.com/login)"
    }
  }
}
cookie_security_audit output schema
{
  "type": "object",
  "properties": {
    "url": {},
    "name": {},
    "path": {},
    "score": {
      "type": "number"
    },
    "domain": {},
    "issues": {},
    "secure": {},
    "cookies": {
      "type": "array"
    },
    "max_age": {},
    "message": {
      "type": "string"
    },
    "httpOnly": {},
    "sameSite": {},
    "host_prefix": {},
    "cookies_found": {
      "type": "number"
    },
    "secure_prefix": {}
  },
  "additionalProperties": true
}
cookie_security_audit annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
web_security_audit
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Run a comprehensive web security audit combining headers, SSL, CORS, and cookies checks — then use an LLM to produce a prioritised remediation plan. Orchestrates security_headers_check + ssl_certificate_check + cors_test + cookie_security_audit in parallel, merges all findings, then asks an AI model to: (1) rank vulnerabilities by real-world exploitability, (2) generate a remediation roadmap, (3) produce fix code snippets for the detected stack. Returns both raw audit data and the AI analysis. Use this as a one-click security posture assessment.

web_security_audit input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://www.ia-qa.com",
      "model": "none"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Full URL to audit (e.g. https://example.com)"
    },
    "model": {
      "type": "string",
      "description": "LLM model for AI analysis (default: \"openai/gpt-oss-20b\"). Set to \"none\" to skip AI analysis."
    },
    "api_key": {
      "type": "string",
      "description": "Your Groq or HuggingFace API key. Required to enable AI analysis."
    }
  }
}
web_security_audit output schema
{
  "type": "object",
  "properties": {
    "fix": {},
    "key": {},
    "url": {},
    "name": {},
    "weak": {},
    "grade": {},
    "score": {},
    "tests": {},
    "value": {},
    "header": {},
    "issues": {},
    "secure": {},
    "weight": {},
    "cookies": {
      "type": "array"
    },
    "details": {},
    "message": {
      "type": "string"
    },
    "missing": {},
    "httpOnly": {},
    "sameSite": {},
    "risk_level": {},
    "weak_count": {
      "type": "number"
    },
    "cookies_found": {
      "type": "number"
    },
    "missing_count": {
      "type": "number"
    },
    "overall_grade": {},
    "origins_tested": {
      "type": "number"
    },
    "total_findings": {
      "type": "number"
    },
    "headers_checked": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
web_security_audit annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
embedding_similarity
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute text similarity using local algorithms (Bag of Words, TF-IDF, Character N-grams). No API key needed — runs entirely in-process. NOT real embeddings: for true semantic similarity with vector embeddings, use run_semantic_tests with mode="embeddings" and your OpenAI API key. Supports single pair or batch mode with pipe-separated pairs. Useful for RAG retrieval testing, semantic search evaluation, and text deduplication.

embedding_similarity input schema
{
  "type": "object",
  "examples": [
    {
      "text_a": "the cat sat",
      "text_b": "quantum field theory"
    }
  ],
  "properties": {
    "batch": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "text_a",
          "text_b"
        ],
        "properties": {
          "text_a": {
            "type": "string"
          },
          "text_b": {
            "type": "string"
          }
        }
      },
      "description": "Batch mode: array of { text_a, text_b } pairs. Overrides text_a/text_b if provided."
    },
    "text_a": {
      "type": "string",
      "description": "First text to compare (single-pair mode)"
    },
    "text_b": {
      "type": "string",
      "description": "Second text to compare (single-pair mode)"
    },
    "methods": {
      "type": "array",
      "items": {
        "enum": [
          "bow",
          "tfidf",
          "ngram"
        ],
        "type": "string"
      },
      "description": "Algorithms to use (default: all three). Options: \"bow\", \"tfidf\", \"ngram\""
    }
  }
}
embedding_similarity output schema
{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "scores": {},
    "text_a": {},
    "text_b": {},
    "results": {}
  },
  "additionalProperties": true
}
embedding_similarity annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
rag_relevance_rank
Advertised by the server during the last successful anonymous check.
Advertised read-only

Rank an array of text chunks by relevance to a query using TF-IDF scoring. Simulates retrieval ranking for RAG testing without needing embeddings or an API.

rag_relevance_rank input schema
{
  "type": "object",
  "examples": [
    {
      "query": "quantum",
      "chunks": [
        "a b c",
        "d e f"
      ]
    }
  ],
  "required": [
    "query",
    "chunks"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The user query"
    },
    "top_k": {
      "type": "number",
      "description": "Return top K results (default: all)"
    },
    "chunks": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of text chunks to rank"
    }
  }
}
rag_relevance_rank output schema
{
  "type": "object",
  "properties": {
    "rank": {
      "type": "number"
    },
    "index": {},
    "query": {},
    "score": {
      "type": "string"
    },
    "results": {},
    "returned": {
      "type": "number"
    },
    "total_chunks": {
      "type": "number"
    },
    "chunk_preview": {},
    "keyword_overlap": {}
  },
  "additionalProperties": true
}
rag_relevance_rank annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
vector_similarity
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute similarity/distance between two float vectors: cosine similarity, dot product, Euclidean and Manhattan distance. Essential for vector DB relevance scoring, embedding evaluation, and nearest-neighbor testing.

vector_similarity input schema
{
  "type": "object",
  "examples": [
    {
      "vector_a": [
        1,
        0
      ],
      "vector_b": [
        0,
        1
      ]
    }
  ],
  "required": [
    "vector_a",
    "vector_b"
  ],
  "properties": {
    "metric": {
      "enum": [
        "cosine",
        "dot_product",
        "euclidean",
        "manhattan",
        "all"
      ],
      "type": "string",
      "description": "Distance metric (default: all)"
    },
    "vector_a": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "First vector as array of floats"
    },
    "vector_b": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Second vector as array of floats"
    }
  }
}
vector_similarity output schema
{
  "type": "object",
  "properties": {
    "norm_a": {},
    "norm_b": {},
    "dimension": {},
    "dot_product": {},
    "interpretation": {},
    "cosine_distance": {},
    "cosine_similarity": {},
    "euclidean_distance": {},
    "manhattan_distance": {}
  },
  "additionalProperties": true
}
vector_similarity annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
normalize_vector
Advertised by the server during the last successful anonymous check.
Advertised read-only

L2-normalize a float vector (produce a unit vector with norm=1). Required by many vector DBs (Pinecone, Qdrant cosine). Supports batch normalization of up to 1000 vectors.

normalize_vector input schema
{
  "type": "object",
  "examples": [
    {
      "vector": [
        3,
        4
      ]
    }
  ],
  "properties": {
    "batch": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "description": "Batch of vectors to normalize (overrides vector)"
    },
    "vector": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Single vector to normalize"
    }
  }
}
normalize_vector output schema
{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string"
    },
    "norm": {
      "type": "number"
    },
    "count": {
      "type": "number"
    },
    "index": {},
    "vector": {},
    "results": {},
    "dimension": {
      "type": "number"
    },
    "norm_after": {
      "type": "number"
    },
    "normalized": {},
    "norm_before": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
normalize_vector annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
vector_quantize
Advertised by the server during the last successful anonymous check.
Advertised read-only

Simulate int8 or int4 quantization of float32 embedding vectors. Reduces storage by 4x (int8) or 8x (int4). Returns quantized values, scale factor, and precision loss (MSE). Useful for understanding vector DB compression trade-offs.

vector_quantize input schema
{
  "type": "object",
  "examples": [
    {
      "vector": [
        0.1,
        -0.5,
        0.9,
        0
      ]
    }
  ],
  "required": [
    "vector"
  ],
  "properties": {
    "bits": {
      "type": "number",
      "description": "Quantization bits: 8 (int8, default) or 4 (int4)"
    },
    "vector": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Float32 vector to quantize"
    }
  }
}
vector_quantize output schema
{
  "type": "object",
  "properties": {
    "mse": {
      "type": "number"
    },
    "bits": {},
    "offset": {
      "type": "number"
    },
    "dimension": {
      "type": "number"
    },
    "quantized": {},
    "scale_factor": {
      "type": "number"
    },
    "compression_ratio": {
      "type": "string"
    },
    "storage_bytes_float32": {},
    "storage_bytes_quantized": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
vector_quantize annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
vector_stats
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute statistics for a float vector or matrix of vectors: mean, std, L2 norm, min, max, sparsity, top-K indices. Useful for debugging embedding quality and analyzing vector distributions in a vector DB.

vector_stats input schema
{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "vector"
      ]
    },
    {
      "required": [
        "matrix"
      ]
    }
  ],
  "examples": [
    {
      "vector": [
        1,
        2,
        3,
        4
      ]
    }
  ],
  "properties": {
    "top_k": {
      "type": "number",
      "description": "Return indices of top K absolute values (default: 5)"
    },
    "matrix": {
      "type": "array",
      "items": {
        "type": "array",
        "items": {
          "type": "number"
        }
      },
      "description": "Matrix of vectors (overrides vector). Returns per-vector + matrix-level stats. Required unless `vector` is given."
    },
    "vector": {
      "type": "array",
      "items": {
        "type": "number"
      },
      "description": "Single vector to analyze. Required unless `matrix` is given."
    }
  }
}
vector_stats output schema
{
  "type": "object",
  "properties": {
    "max": {
      "type": "number"
    },
    "min": {
      "type": "number"
    },
    "std": {
      "type": "number"
    },
    "mean": {
      "type": "number"
    },
    "l2_norm": {
      "type": "number"
    },
    "sparsity": {
      "type": "number"
    },
    "dimension": {},
    "per_vector": {},
    "matrix_shape": {
      "type": "array"
    },
    "matrix_stats": {
      "type": "object"
    },
    "top_k_indices": {}
  },
  "additionalProperties": true
}
vector_stats annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
bm25_score
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute BM25 relevance score between a query and one or more documents. BM25 is the industry-standard keyword-based ranking algorithm used in Elasticsearch, OpenSearch, and Weaviate hybrid search. Returns ranked results with normalized scores.

bm25_score input schema
{
  "type": "object",
  "examples": [
    {
      "query": "refund damaged",
      "documents": [
        "shipping times",
        "refund for damaged items",
        "office hours"
      ]
    }
  ],
  "required": [
    "query",
    "documents"
  ],
  "properties": {
    "b": {
      "type": "number",
      "description": "Length normalization factor (default: 0.75)"
    },
    "k1": {
      "type": "number",
      "description": "Term frequency saturation (default: 1.5)"
    },
    "query": {
      "type": "string",
      "description": "The search query"
    },
    "top_k": {
      "type": "number",
      "description": "Return top K results (default: all)"
    },
    "documents": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of documents to rank"
    }
  }
}
bm25_score output schema
{
  "type": "object",
  "properties": {
    "b": {},
    "k1": {},
    "index": {},
    "query": {},
    "results": {},
    "bm25_score": {
      "type": "number"
    },
    "doc_length": {
      "type": "number"
    },
    "doc_preview": {},
    "avg_doc_length": {
      "type": "number"
    },
    "documents_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
bm25_score annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
build_rag_prompt
Advertised by the server during the last successful anonymous check.
Advertised read-only

Assemble a complete RAG (Retrieval-Augmented Generation) prompt from retrieved context chunks and a user query. Handles token budgeting, citation numbering, system instruction injection, and source attribution.

build_rag_prompt input schema
{
  "type": "object",
  "examples": [
    {
      "query": "q?",
      "chunks": [
        {
          "text": "c1 text",
          "source": "a.md"
        }
      ]
    }
  ],
  "required": [
    "query",
    "chunks"
  ],
  "properties": {
    "query": {
      "type": "string",
      "description": "The user question to answer"
    },
    "chunks": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "text": {
            "type": "string"
          },
          "score": {
            "type": "number"
          },
          "source": {
            "type": "string"
          }
        }
      },
      "description": "Retrieved context chunks with .text (required), .source (optional), .score (optional)"
    },
    "language": {
      "type": "string",
      "description": "Response language instruction (e.g. \"French\", \"Spanish\")"
    },
    "cite_sources": {
      "type": "boolean",
      "description": "Add [1], [2] citation numbers (default: true)"
    },
    "max_context_tokens": {
      "type": "number",
      "description": "Max tokens for context section (default: 2000)"
    },
    "system_instruction": {
      "type": "string",
      "description": "Custom system instruction (default: standard RAG grounding instruction)"
    }
  }
}
build_rag_prompt output schema
{
  "type": "object",
  "properties": {
    "prompt": {},
    "system_prompt": {},
    "chunks_included": {
      "type": "number"
    },
    "included_chunks": {},
    "chunks_truncated": {
      "type": "number"
    },
    "total_tokens_estimate": {
      "type": "number"
    },
    "context_tokens_estimate": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
build_rag_prompt annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
prompt_template_fill
Advertised by the server during the last successful anonymous check.
Advertised read-only

Fill a prompt template with variables. Supports {{variable}} syntax and {{#if key}}...{{/if}} conditional blocks. Returns the filled prompt and lists unfilled variables.

prompt_template_fill input schema
{
  "type": "object",
  "examples": [
    {
      "template": "Hi {{name}}",
      "variables": {
        "name": "A"
      }
    }
  ],
  "required": [
    "template"
  ],
  "properties": {
    "strict": {
      "type": "boolean",
      "description": "Throw error if any variable is not provided (default: false)"
    },
    "template": {
      "type": "string",
      "description": "Prompt template with {{variable}} placeholders"
    },
    "variables": {
      "type": "object",
      "description": "Key-value pairs to fill (e.g. {\"name\":\"Alice\",\"role\":\"engineer\"})",
      "additionalProperties": true
    }
  }
}
prompt_template_fill output schema
{
  "type": "object",
  "properties": {
    "result": {},
    "total_vars": {},
    "filled_variables": {},
    "unfilled_variables": {}
  },
  "additionalProperties": true
}
prompt_template_fill annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
few_shot_formatter
Advertised by the server during the last successful anonymous check.
Advertised read-only

Format few-shot examples for LLM prompts. Converts example pairs into formatted blocks. Supports chat format (User/Assistant), XML tags, Markdown, or plain text.

few_shot_formatter input schema
{
  "type": "object",
  "examples": [
    {
      "examples": [
        {
          "input": "a",
          "output": "b"
        },
        {
          "input": "c",
          "output": "d"
        }
      ]
    }
  ],
  "required": [
    "examples"
  ],
  "properties": {
    "format": {
      "enum": [
        "chat",
        "xml",
        "markdown",
        "plain"
      ],
      "type": "string",
      "description": "Output format (default: chat)"
    },
    "examples": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "input": {
            "type": "string"
          },
          "label": {
            "type": "string"
          },
          "output": {
            "type": "string"
          }
        }
      },
      "description": "Array of {input, output} pairs"
    },
    "input_label": {
      "type": "string",
      "description": "Label for input (default: User / <input>)"
    },
    "output_label": {
      "type": "string",
      "description": "Label for output (default: Assistant / <output>)"
    }
  }
}
few_shot_formatter output schema
{
  "type": "object",
  "properties": {
    "format": {},
    "formatted": {},
    "example_count": {
      "type": "number"
    },
    "token_estimate": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
few_shot_formatter annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
system_prompt_builder
Advertised by the server during the last successful anonymous check.
Advertised read-only

Build a structured system prompt from components: role, task, constraints, output format, tone, language, and examples. Generates a production-ready system prompt with token estimate.

system_prompt_builder input schema
{
  "type": "object",
  "examples": [
    {
      "role": "support agent",
      "constraints": [
        "no PII"
      ],
      "output_format": "json"
    }
  ],
  "required": [
    "role"
  ],
  "properties": {
    "role": {
      "type": "string",
      "description": "Role/persona (e.g. \"Senior QA Engineer\", \"JSON extraction assistant\")"
    },
    "task": {
      "type": "string",
      "description": "Main task or objective"
    },
    "tone": {
      "enum": [
        "professional",
        "friendly",
        "concise",
        "technical",
        "educational"
      ],
      "type": "string",
      "description": "Communication tone"
    },
    "examples": {
      "type": "string",
      "description": "Brief examples to include"
    },
    "language": {
      "type": "string",
      "description": "Response language (e.g. \"French\")"
    },
    "constraints": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Rules and constraints to follow"
    },
    "output_format": {
      "type": "string",
      "description": "Expected output format description"
    }
  }
}
system_prompt_builder output schema
{
  "type": "object",
  "properties": {
    "sections": {
      "type": "object"
    },
    "system_prompt": {},
    "token_estimate": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
system_prompt_builder annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
rerank_evaluate
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Evaluate RAG retrieval: rank passages against a query, compute Precision@k / Recall@k and a PASS/FAIL verdict from your relevance labels. Modes: (1) give every passage the `score` YOUR reranker produced — deterministic, offline, the mode to gate CI on; (2) no scores, no key — a local BM25 keyword baseline, never a judgement of a neural reranker; (3) api_key for an NVIDIA account that still has reranking (NVIDIA retired the hosted endpoints on 2026-05-18).

rerank_evaluate input schema
{
  "type": "object",
  "examples": [
    {
      "query": "capital of France",
      "api_key": "<your-api-key>",
      "passages": [
        {
          "text": "Paris is the capital of France.",
          "relevant": true
        },
        {
          "text": "Bananas are rich in potassium.",
          "relevant": false
        }
      ]
    }
  ],
  "required": [
    "query",
    "passages"
  ],
  "properties": {
    "query": {
      "type": "string"
    },
    "top_k": {
      "type": "integer",
      "maximum": 10,
      "minimum": 1,
      "description": "Default 3."
    },
    "api_key": {
      "type": "string",
      "description": "NVIDIA key, used only when no passage has a score; never stored."
    },
    "passages": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "text"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "text": {
            "type": "string"
          },
          "score": {
            "type": "number",
            "description": "Your reranker's score (higher = more relevant). On all passages or none."
          },
          "relevant": {
            "type": "boolean",
            "description": "Ground truth."
          }
        }
      },
      "description": "2 to 20 passages."
    },
    "threshold": {
      "type": "number",
      "maximum": 1,
      "minimum": 0,
      "description": "Minimum Precision@k to PASS (default 0.5)."
    }
  }
}
rerank_evaluate output schema
{
  "type": "object",
  "properties": {
    "k": {
      "type": "number"
    },
    "mode": {
      "type": "string"
    },
    "model": {
      "type": "string"
    },
    "ranked": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "verdict": {
      "type": "string"
    },
    "threshold": {
      "type": "number"
    },
    "latency_ms": {
      "type": "number"
    },
    "recall_at_k": {
      "type": "number"
    },
    "precision_at_k": {
      "type": "number"
    },
    "total_passages": {
      "type": "number"
    },
    "has_ground_truth": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
rerank_evaluate annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
count_tokens
Advertised by the server during the last successful anonymous check.
Advertised read-only

Estimate the token count of a text string using the cl100k_base approximation (~4 chars/token). Call this BEFORE sending any text to an LLM API to check if it fits within the model context window and to estimate cost. Returns token estimate, character count, and word count.

count_tokens input schema
{
  "type": "object",
  "examples": [
    {
      "input": "Hello world, this is a test."
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to count tokens for"
    }
  }
}
count_tokens output schema
{
  "type": "object",
  "properties": {
    "chars": {},
    "words": {},
    "tokens_estimate": {}
  },
  "additionalProperties": true
}
count_tokens annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
truncate_to_tokens
Advertised by the server during the last successful anonymous check.
Advertised read-only

Truncate text to at most N tokens (cl100k_base: ~4 chars/token) to avoid exceeding an LLM context window. Optionally keeps the end of the text instead of the start (useful for keeping recent conversation history). Reports whether truncation occurred and the estimated token count.

truncate_to_tokens input schema
{
  "type": "object",
  "examples": [
    {
      "input": "short",
      "max_tokens": 50
    }
  ],
  "required": [
    "input",
    "max_tokens"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to truncate"
    },
    "from_end": {
      "type": "boolean",
      "description": "Keep the end of the text instead of the start (default: false)"
    },
    "max_tokens": {
      "type": "number",
      "description": "Maximum number of tokens to keep"
    }
  }
}
truncate_to_tokens output schema
{
  "type": "object",
  "properties": {
    "text": {},
    "truncated": {
      "type": "boolean"
    },
    "tokens_estimate": {},
    "original_tokens_estimate": {}
  },
  "additionalProperties": true
}
truncate_to_tokens annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
split_chunks
Advertised by the server during the last successful anonymous check.
Advertised read-only

Split text into chunks of at most N tokens (cl100k_base: ~4 chars/token) with optional overlap. Designed for RAG ingestion pipelines.

split_chunks input schema
{
  "type": "object",
  "examples": [
    {
      "input": "Refunds are accepted within 30 days. Damaged items are replaced for free. Contact support to start a return.",
      "overlap": 2,
      "chunk_tokens": 12
    }
  ],
  "required": [
    "input",
    "chunk_tokens"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to split into chunks"
    },
    "overlap": {
      "type": "number",
      "description": "Token overlap between consecutive chunks (default: 0)"
    },
    "chunk_tokens": {
      "type": "number",
      "description": "Maximum tokens per chunk (10–8000)"
    }
  }
}
split_chunks output schema
{
  "type": "object",
  "properties": {
    "chunks": {
      "type": "array"
    },
    "chunk_count": {
      "type": "number"
    },
    "overlap_tokens": {},
    "tokens_per_chunk": {}
  },
  "additionalProperties": true
}
split_chunks annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
extract_json_from_text
Advertised by the server during the last successful anonymous check.
Advertised read-only

Extract the first valid JSON object or array embedded in chaotic LLM output (surrounded by markdown fences, prose, or explanatory text). Handles ```json blocks and inline JSON. Call this whenever an LLM returns structured data mixed with explanation text instead of raw JSON.

extract_json_from_text input schema
{
  "type": "object",
  "examples": [
    {
      "input": "Here:\n```json\n{\"a\":[1,2]}\n```\nthanks"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Raw text (e.g., LLM output) that may contain a JSON object or array"
    }
  }
}
extract_json_from_text output schema
{
  "type": "object",
  "properties": {
    "json": {},
    "source": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
extract_json_from_text annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
estimate_llm_cost
Advertised by the server during the last successful anonymous check.
Advertised read-only

Estimate the API cost in USD for a given model and token counts, at the price read daily from the provider's own pricing page (prices_as_of, price_status). Any model from list_llm_models.

estimate_llm_cost input schema
{
  "type": "object",
  "examples": [
    {
      "model": "gpt-4o",
      "input_tokens": 1000000,
      "output_tokens": 1000000
    }
  ],
  "required": [
    "model",
    "input_tokens"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Model name, e.g. \"gpt-4o\", \"claude-3.5-sonnet\", \"deepseek-v3\""
    },
    "input_tokens": {
      "type": "number",
      "description": "Number of input/prompt tokens"
    },
    "output_tokens": {
      "type": "number",
      "description": "Number of output/completion tokens (default: 0)"
    }
  }
}
estimate_llm_cost output schema
{
  "type": "object",
  "properties": {
    "model": {},
    "rates": {
      "type": "object"
    },
    "input_tokens": {},
    "output_tokens": {},
    "input_cost_usd": {
      "type": "string"
    },
    "total_cost_usd": {
      "type": "string"
    },
    "output_cost_usd": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
estimate_llm_cost annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
token_budget_calculator
Advertised by the server during the last successful anonymous check.
Advertised read-only

Plan token allocation across system prompt, user input, context/RAG chunks, and expected output. Warns if budget exceeds the model's context window (any model from list_llm_models).

token_budget_calculator input schema
{
  "type": "object",
  "examples": [
    {
      "model": "gpt-4o",
      "context_tokens": 1000,
      "expected_output_tokens": 500
    }
  ],
  "required": [
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Model id from list_llm_models (e.g. gpt-6.1-sol, claude-sonnet-5-5, gemini-3.8-flash)"
    },
    "context": {
      "type": "string",
      "description": "Actual context text (will estimate tokens)"
    },
    "user_input": {
      "type": "string",
      "description": "Actual user input text (will estimate tokens)"
    },
    "system_prompt": {
      "type": "string",
      "description": "Actual system prompt text (will estimate tokens)"
    },
    "context_tokens": {
      "type": "number",
      "description": "Token count for RAG context / documents"
    },
    "user_input_tokens": {
      "type": "number",
      "description": "Token count for user message"
    },
    "system_prompt_tokens": {
      "type": "number",
      "description": "Token count for system prompt"
    },
    "expected_output_tokens": {
      "type": "number",
      "description": "Expected max output tokens"
    }
  }
}
token_budget_calculator output schema
{
  "type": "object",
  "properties": {
    "model": {},
    "warnings": {},
    "breakdown": {
      "type": "object"
    },
    "context_window": {},
    "fits_in_window": {},
    "remaining_tokens": {},
    "utilization_percent": {}
  },
  "additionalProperties": true
}
token_budget_calculator annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
context_window_check
Advertised by the server during the last successful anonymous check.
Advertised read-only

Given an array of message objects [{role, content}], estimate total token usage and check if it fits in the target model's context window. Warns about truncation risk.

context_window_check input schema
{
  "type": "object",
  "examples": [
    {
      "model": "gpt-4o",
      "messages": [
        {
          "role": "user",
          "content": "hi"
        }
      ]
    }
  ],
  "required": [
    "messages",
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Model id from list_llm_models (e.g. gpt-6.1-sol, claude-sonnet-5-5)"
    },
    "messages": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "role": {
            "type": "string"
          },
          "content": {
            "type": "string"
          }
        }
      },
      "description": "Array of messages (system/user/assistant)"
    },
    "max_output_tokens": {
      "type": "number",
      "description": "Reserved tokens for output (default: 4096)"
    }
  }
}
context_window_check output schema
{
  "type": "object",
  "properties": {
    "fits": {},
    "role": {},
    "chars": {
      "type": "number"
    },
    "index": {},
    "model": {},
    "tokens": {},
    "warnings": {},
    "breakdown": {
      "type": "object"
    },
    "per_message": {},
    "total_tokens": {},
    "message_count": {
      "type": "number"
    },
    "context_window": {},
    "total_input_tokens": {},
    "utilization_percent": {
      "type": "string"
    },
    "reserved_output_tokens": {}
  },
  "additionalProperties": true
}
context_window_check annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
model_info
Advertised by the server during the last successful anonymous check.
Advertised read-only

Get detailed specs for an AI model: context window, pricing per 1K tokens, knowledge cutoff, provider, multimodal support, reasoning capabilities, and feature list. Covers 30+ models from OpenAI, Anthropic, Google, DeepSeek, Meta, Mistral, Cohere, xAI.

model_info input schema
{
  "type": "object",
  "examples": [
    {
      "model": "gpt-4o"
    }
  ],
  "required": [
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Model name (e.g. \"gpt-4o\", \"claude-3.5-sonnet\", \"gemini-3.1-pro-preview\")"
    }
  }
}
model_info output schema
{
  "type": "object",
  "properties": {
    "model": {},
    "pricing_per_1k": {
      "type": "object"
    }
  },
  "additionalProperties": true
}
model_info annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
compare_models
Advertised by the server during the last successful anonymous check.
Advertised read-only

Put 2-5 AI models side by side: price per 1k tokens, context window, multimodal, reasoning, provider, pricing page. Facts only: names the cheapest and the largest context, never a "best model" — run your cases on each to choose.

compare_models input schema
{
  "type": "object",
  "examples": [
    {
      "models": [
        "gpt-6.1-sol",
        "claude-sonnet-5-5"
      ]
    }
  ],
  "required": [
    "models"
  ],
  "properties": {
    "models": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Array of 2-5 model names (e.g. [\"gpt-5\",\"claude-sonnet-4-6\",\"gemini-3.5-flash\"])"
    }
  }
}
compare_models output schema
{
  "type": "object",
  "properties": {
    "rows": {},
    "cheapest": {},
    "prices_as_of": {},
    "largest_context": {},
    "models_compared": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
compare_models annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
list_llm_models
Advertised by the server during the last successful anonymous check.
Advertised read-only

List all LLM models available on ia-qa.com with their provider, API endpoint, and capabilities. Filter by provider name (e.g. "Groq", "HuggingFace", "OpenAI") or return the full catalog. Use this to discover which models are available before calling an LLM API, or to compare providers.

list_llm_models input schema
{
  "type": "object",
  "examples": [
    {
      "provider": "groq"
    }
  ],
  "properties": {
    "provider": {
      "type": "string",
      "description": "Filter by provider name (case-insensitive). E.g. \"Groq\", \"HuggingFace\", \"OpenAI\", \"Anthropic\", \"Google\", \"DeepSeek\", \"xAI\", \"Ollama\". Omit for full catalog."
    }
  }
}
list_llm_models output schema
{
  "type": "object",
  "properties": {
    "total": {
      "type": "number"
    },
    "filter": {},
    "models": {},
    "providers": {}
  },
  "additionalProperties": true
}
list_llm_models annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
llm_generate
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Generate text with an open-source model hosted on Groq, on the server's key — no API key needed. Models: openai/gpt-oss-20b, openai/gpt-oss-120b, qwen/qwen3.8-27b (default "openai/gpt-oss-20b"). HuggingFace models are not served on the server key. A reasoning model that spends max_tokens thinking is retried once at 4096. Rate-limited.

llm_generate input schema
{
  "type": "object",
  "examples": [
    {
      "prompt": "Reply with the single word OK."
    }
  ],
  "required": [
    "prompt"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "Model ID (default: \"openai/gpt-oss-20b\"). Server-keyed whitelist only — Groq: openai/gpt-oss-20b, openai/gpt-oss-120b, qwen/qwen3.8-27b. Other ids from list_llm_models, HuggingFace ones included, are BYOK-only and will be rejected."
    },
    "prompt": {
      "type": "string",
      "description": "The user prompt / instruction to send to the model"
    },
    "system": {
      "type": "string",
      "description": "Optional system prompt to set context or persona"
    },
    "max_tokens": {
      "type": "number",
      "description": "Maximum tokens to generate (default: 2048, max: 4096)"
    },
    "temperature": {
      "type": "number",
      "description": "Sampling temperature 0.0–1.5 (default: 0.7)"
    }
  }
}
llm_generate output schema
{
  "type": "object",
  "properties": {
    "model": {},
    "usage": {},
    "content": {},
    "provider": {},
    "latency_ms": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
llm_generate annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
optimize_prompt_tokens
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compress an LLM prompt by removing filler words, verbose phrases, duplicate sentences, and unnecessary whitespace. Returns optimized text with token savings breakdown. 100% deterministic, no API key needed.

optimize_prompt_tokens input schema
{
  "type": "object",
  "examples": [
    {
      "text": "Please   kindly    make sure that you   basically   summarize   the following text."
    }
  ],
  "required": [
    "text"
  ],
  "properties": {
    "text": {
      "type": "string",
      "description": "The prompt text to optimize"
    },
    "options": {
      "type": "object",
      "properties": {
        "fillers": {
          "type": "boolean",
          "default": true
        },
        "duplicates": {
          "type": "boolean",
          "default": true
        },
        "whitespace": {
          "type": "boolean",
          "default": true
        },
        "instructions": {
          "type": "boolean",
          "default": true
        }
      },
      "description": "Toggle optimization steps (all true by default)"
    }
  }
}
optimize_prompt_tokens output schema
{
  "type": "object",
  "properties": {
    "steps": {},
    "optimized": {},
    "tokens_after": {},
    "tokens_saved": {},
    "percent_saved": {
      "type": "string"
    },
    "tokens_before": {}
  },
  "additionalProperties": true
}
optimize_prompt_tokens annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
llm_fit_finder
Advertised by the server during the last successful anonymous check.
Advertised read-only

Shortlist LLMs on facts, no ranking: cloud models with the features you need within a monthly budget, cheapest first; or local models that fit your VRAM, largest first, with the ollama command. To pick one, run your cases on the shortlist (prompt_test_suite, run_eval_contract).

llm_fit_finder input schema
{
  "type": "object",
  "examples": [
    {
      "top_n": 5,
      "features": [
        "vision"
      ],
      "use_case": "chatbot"
    }
  ],
  "properties": {
    "mode": {
      "type": "string",
      "description": "cloud (API models) or local (Ollama/self-hosted). Default: cloud"
    },
    "top_n": {
      "type": "number",
      "description": "Number of models to return (default: 5)"
    },
    "vram_gb": {
      "type": "number",
      "description": "GPU VRAM in GB (only for mode=local). Default: 16"
    },
    "features": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Required features: vision, function_calling, json_mode, streaming, reasoning"
    },
    "use_case": {
      "type": "string",
      "description": "Only \"reasoning\" filters (requires the feature); chatbot | code | rag | summarization | classification | agents | multilingual rank nothing"
    },
    "max_budget": {
      "type": "number",
      "description": "Maximum monthly budget in USD (based on tokens_per_day)"
    },
    "quantization": {
      "type": "string",
      "description": "Quantization (only for mode=local): Q4_K_M | Q8_0 | FP16. Default: Q4_K_M"
    },
    "tokens_per_day": {
      "type": "number",
      "description": "Estimated daily token volume (default: 100000)"
    }
  }
}
llm_fit_finder output schema
{
  "type": "object",
  "properties": {
    "mode": {
      "type": "string"
    },
    "note": {
      "type": "string"
    },
    "order": {
      "type": "string"
    },
    "results": {
      "type": "array"
    },
    "vram_gb": {},
    "use_case": {},
    "prices_as_of": {},
    "quantization": {},
    "tokens_per_day": {},
    "total_matching": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
llm_fit_finder annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
post_jira_comment
Advertised by the server during the last successful anonymous check.

Post the output of jira_to_test_suite as a formatted comment on the source Jira ticket. Converts Gherkin, E2E steps, API tests, and ambiguities into Atlassian Document Format (ADF). STATEFUL — creates a comment on the issue.

post_jira_comment input schema
{
  "type": "object",
  "examples": [
    {
      "issue_key": "PROJ-1",
      "jira_email": "you@example.com",
      "jira_token": "<your-atlassian-token>",
      "test_suite": {
        "acceptance_criteria": [
          "A reset link expires 30 minutes after it is sent."
        ]
      },
      "jira_base_url": "https://yourcompany.atlassian.net"
    }
  ],
  "required": [
    "issue_key",
    "jira_base_url",
    "jira_email",
    "jira_token",
    "test_suite"
  ],
  "properties": {
    "issue_key": {
      "type": "string",
      "description": "Jira issue key, e.g. \"PROJ-123\""
    },
    "jira_email": {
      "type": "string",
      "description": "Atlassian account email"
    },
    "jira_token": {
      "type": "string",
      "description": "Atlassian API token"
    },
    "test_suite": {
      "type": "object",
      "description": "The test_suite object from jira_to_test_suite result",
      "additionalProperties": true
    },
    "jira_base_url": {
      "type": "string",
      "description": "Atlassian base URL"
    }
  }
}
post_jira_comment output schema
{
  "type": "object",
  "properties": {
    "success": {
      "type": "boolean"
    },
    "comment_id": {
      "type": "string"
    },
    "comment_url": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
post_jira_comment annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
create_confluence_page
Advertised by the server during the last successful anonymous check.

Create a new Confluence page from the output of jira_to_test_suite. Formats Gherkin, E2E steps, API tests, and test data as a properly structured Confluence page with code blocks and tables. STATEFUL — creates a new page in the specified space.

create_confluence_page input schema
{
  "type": "object",
  "examples": [
    {
      "space_key": "QA",
      "test_suite": {
        "acceptance_criteria": [
          "A reset link expires 30 minutes after it is sent."
        ]
      },
      "confluence_email": "you@example.com",
      "confluence_token": "<your-atlassian-token>",
      "confluence_base_url": "https://yourcompany.atlassian.net"
    }
  ],
  "required": [
    "confluence_base_url",
    "confluence_email",
    "confluence_token",
    "space_key",
    "test_suite"
  ],
  "properties": {
    "title": {
      "type": "string",
      "description": "Page title. Defaults to \"Test Plan: {issue_key}\""
    },
    "issue_key": {
      "type": "string",
      "description": "Source Jira issue key (for the page title and source link)"
    },
    "issue_url": {
      "type": "string",
      "description": "Source Jira issue URL (added as a link in the page)"
    },
    "space_key": {
      "type": "string",
      "description": "Confluence space key where the page will be created, e.g. \"QA\", \"ENG\""
    },
    "test_suite": {
      "type": "object",
      "description": "The test_suite object from jira_to_test_suite result",
      "additionalProperties": true
    },
    "parent_page_id": {
      "type": "string",
      "description": "Optional parent page ID — page will be created as a child of this page"
    },
    "confluence_email": {
      "type": "string",
      "description": "Atlassian account email"
    },
    "confluence_token": {
      "type": "string",
      "description": "Atlassian API token"
    },
    "confluence_base_url": {
      "type": "string",
      "description": "Atlassian base URL"
    }
  }
}
create_confluence_page output schema
{
  "type": "object",
  "properties": {
    "title": {
      "type": "string"
    },
    "page_id": {
      "type": "string"
    },
    "success": {
      "type": "boolean"
    },
    "page_url": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
create_confluence_page annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
fetch_jira_issue
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Fetch a complete Jira issue: summary, description converted to Markdown, status, assignee, priority, labels, custom fields, and optionally comments and attachment metadata. BYOK — credentials transit in-memory only, never stored on ia-qa.com.

fetch_jira_issue input schema
{
  "type": "object",
  "examples": [
    {
      "issue_key": "PROJ-1",
      "jira_email": "you@example.com",
      "jira_token": "<your-atlassian-token>",
      "jira_base_url": "https://yourcompany.atlassian.net"
    }
  ],
  "required": [
    "issue_key",
    "jira_base_url",
    "jira_email",
    "jira_token"
  ],
  "properties": {
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Specific Jira field names to return. Omit for all standard fields."
    },
    "issue_key": {
      "type": "string",
      "description": "Jira issue key, e.g. \"PROJ-123\""
    },
    "jira_email": {
      "type": "string",
      "description": "Atlassian account email"
    },
    "jira_token": {
      "type": "string",
      "description": "Atlassian API token (from id.atlassian.com > Security > API tokens)"
    },
    "jira_base_url": {
      "type": "string",
      "description": "Atlassian base URL, e.g. \"https://mycompany.atlassian.net\""
    },
    "include_comments": {
      "type": "boolean",
      "description": "Include issue comments, up to 20 (default: true)"
    },
    "include_attachments": {
      "type": "boolean",
      "description": "Include attachment metadata list (default: false)"
    }
  }
}
fetch_jira_issue output schema
{
  "type": "object",
  "properties": {
    "key": {
      "type": "string"
    },
    "url": {
      "type": "string"
    },
    "type": {
      "type": "string"
    },
    "labels": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "status": {
      "type": "string"
    },
    "summary": {
      "type": "string"
    },
    "assignee": {
      "type": "string"
    },
    "priority": {
      "type": "string"
    },
    "reporter": {
      "type": "string"
    },
    "description": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
fetch_jira_issue annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
search_jira_issues
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Search Jira using JQL (Jira Query Language). Returns matching issues with key fields. Ideal for finding open bugs, sprint tickets, or issues by label/assignee/component. BYOK — credentials transit in-memory only, never stored.

search_jira_issues input schema
{
  "type": "object",
  "examples": [
    {
      "jql": "project = PROJ AND status = \"To Do\"",
      "jira_email": "you@example.com",
      "jira_token": "<your-atlassian-token>",
      "jira_base_url": "https://yourcompany.atlassian.net"
    }
  ],
  "required": [
    "jql",
    "jira_base_url",
    "jira_email",
    "jira_token"
  ],
  "properties": {
    "jql": {
      "type": "string",
      "description": "JQL query string, e.g. \"project = PROJ AND status = Open AND assignee = currentUser() ORDER BY priority DESC\""
    },
    "fields": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Fields per issue. Default: summary, status, assignee, priority, issuetype, labels, created, updated"
    },
    "jira_email": {
      "type": "string",
      "description": "Atlassian account email"
    },
    "jira_token": {
      "type": "string",
      "description": "Atlassian API token"
    },
    "max_results": {
      "type": "number",
      "description": "Max issues to return (default: 10, max: 50)"
    },
    "jira_base_url": {
      "type": "string",
      "description": "Atlassian base URL, e.g. \"https://mycompany.atlassian.net\""
    }
  }
}
search_jira_issues output schema
{
  "type": "object",
  "properties": {
    "jql": {
      "type": "string"
    },
    "total": {
      "type": "number"
    },
    "issues": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "returned": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
search_jira_issues annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
fix_gherkin
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Fix Gherkin syntax warnings from a jira_to_test_suite result. Takes the current gherkin text and the _gherkin_warnings array, calls your LLM to fix ONLY the flagged issues (adds missing Given/When/Then steps, etc.), and returns the corrected Gherkin. Lightweight — uses ~300-500 tokens vs ~5k for a full regeneration. Requires BYOK LLM key.

fix_gherkin input schema
{
  "type": "object",
  "examples": [
    {
      "model": "gpt-4o-mini",
      "api_key": "<your-api-key>",
      "gherkin": "Feature: Login\n  Scenario: ok\n    given I open the page\n    Then I see the form",
      "warnings": [
        "Step keyword \"given\" should be capitalised"
      ]
    }
  ],
  "required": [
    "gherkin",
    "warnings",
    "api_key",
    "model"
  ],
  "properties": {
    "model": {
      "type": "string",
      "description": "LLM model to use for the fix, e.g. \"gpt-4o-mini\". Must belong to the provider whose key you passed in api_key."
    },
    "api_key": {
      "type": "string",
      "description": "Your own LLM provider API key (BYOK) — OpenAI \"sk-…\", Anthropic \"sk-ant-…\", Google \"AIzaSy…\", or Groq \"gsk_…\". There is no server-side key for this tool: if you do not have one, do not call it and do not invent a value — placeholders like \"configured\", \"your_api_key\" or a masked \"sk-…***…\" are rejected. Used for this call only, never stored."
    },
    "gherkin": {
      "type": "string",
      "description": "The current Gherkin text from the jira_to_test_suite result (test_suite.gherkin)."
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "The _gherkin_warnings array from the jira_to_test_suite result."
    }
  }
}
fix_gherkin output schema
{
  "type": "object",
  "properties": {
    "latency_ms": {
      "type": "number"
    },
    "model_used": {
      "type": "string"
    },
    "fixed_gherkin": {
      "type": "string"
    },
    "warnings_after": {
      "type": "number"
    },
    "warnings_before": {
      "type": "number"
    },
    "remaining_warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}
fix_gherkin annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
fetch_confluence_page
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Fetch a Confluence page and return its content as clean Markdown. Accepts a numeric page_id or a full page URL. Optionally lists direct child pages. BYOK — credentials transit in-memory only, never stored.

fetch_confluence_page input schema
{
  "type": "object",
  "examples": [
    {
      "page_id": "123456",
      "confluence_email": "you@example.com",
      "confluence_token": "<your-atlassian-token>",
      "confluence_base_url": "https://yourcompany.atlassian.net"
    }
  ],
  "required": [
    "confluence_base_url",
    "confluence_email",
    "confluence_token"
  ],
  "properties": {
    "page_id": {
      "type": "string",
      "description": "Confluence page ID (numeric string), e.g. \"123456789\""
    },
    "page_url": {
      "type": "string",
      "description": "Full Confluence page URL (alternative to page_id), e.g. \"https://mycompany.atlassian.net/wiki/spaces/ENG/pages/123456789\""
    },
    "confluence_email": {
      "type": "string",
      "description": "Atlassian account email (same credentials as Jira)"
    },
    "confluence_token": {
      "type": "string",
      "description": "Atlassian API token"
    },
    "include_children": {
      "type": "boolean",
      "description": "List direct child pages (id + title) (default: false)"
    },
    "confluence_base_url": {
      "type": "string",
      "description": "Atlassian base URL, e.g. \"https://mycompany.atlassian.net\""
    }
  }
}
fetch_confluence_page output schema
{
  "type": "object",
  "properties": {
    "url": {
      "type": "string"
    },
    "title": {
      "type": "string"
    },
    "page_id": {
      "type": "string"
    },
    "children": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "markdown": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
fetch_confluence_page annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
identify_caller
Advertised by the server during the last successful anonymous check.
Advertised read-only

Returns what the server knows about the current MCP client: clientInfo captured during initialize, User-Agent, and any _meta fields sent with this request. Useful for debugging caller identification.

identify_caller input schema
{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "_meta": {
      "type": "object",
      "properties": {
        "agent": {
          "type": "string"
        },
        "model": {
          "type": "string"
        },
        "version": {
          "type": "string"
        }
      },
      "description": "Optional self-identification. Keys: agent (string), model (string), version (string)."
    }
  }
}
identify_caller output schema
{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "session": {
      "type": "object"
    },
    "meta_override": {
      "type": "object"
    },
    "effective_agent": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
identify_caller annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
rate_tool
Advertised by the server during the last successful anonymous check.

Give honest usage feedback on an IA-QA MCP tool. Give a score (1-5) and a comment. Rate low (1-2) if the tool was wrong, irrelevant, or a poor fit; rate high (4-5) only if it genuinely solved your need. Maintainers read ratings, one vote per agent and tool a month: comments and per-tool scores are not published, only the overall average and vote count. Comments are screened: one carrying a credential is not stored, personal data becomes placeholders — describe what happened, not what a model should do. Skip routine successes: signal, not praise. Example: rate_tool({ tool_name: "format_json", score: 2, comment: "Tried to pretty-print a JSON5 file, it rejected trailing commas — not usable for my case." })

rate_tool input schema
{
  "type": "object",
  "examples": [
    {
      "score": 4,
      "comment": "Formatted a 2 MB payload correctly.",
      "tool_name": "format_json"
    }
  ],
  "required": [
    "tool_name",
    "score"
  ],
  "properties": {
    "score": {
      "type": "number",
      "maximum": 5,
      "minimum": 1,
      "description": "Rating from 1 (poor) to 5 (excellent)"
    },
    "comment": {
      "type": "string",
      "description": "Strongly encouraged — explain what you were trying to do and whether the tool got you there. Be specific about what was missing, wrong, or a poor fit. This is the most valuable part of the rating. Up to 2000 chars are stored; go over and the response says so (truncated: true) — send the remainder as a second call rather than assuming it landed."
    },
    "tool_name": {
      "type": "string",
      "description": "Name of the MCP tool to rate (e.g. \"format_json\", \"shield_analyze\")"
    }
  }
}
rate_tool output schema
{
  "type": "object",
  "properties": {
    "ok": {
      "type": "boolean"
    },
    "score": {},
    "comment": {},
    "message": {
      "type": "string"
    },
    "rated_at": {
      "type": "string"
    },
    "tool_name": {},
    "truncated": {
      "type": "boolean"
    },
    "stored_chars": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
rate_tool annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
validate_email
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate an email address against RFC 5322 syntax before storing it, sending a transactional email, or adding it to a mailing list. Returns { valid, email } — use this to avoid bounces and malformed data.

validate_email input schema
{
  "type": "object",
  "examples": [
    {
      "email": "john.doe@example.com"
    }
  ],
  "required": [
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email address to validate"
    }
  }
}
validate_email output schema
{
  "type": "object",
  "properties": {
    "email": {},
    "valid": {
      "type": "boolean"
    },
    "reason": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
validate_email annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
minify_js
Advertised by the server during the last successful anonymous check.
Advertised read-only

Minify a JavaScript snippet, function, class, or module up to 50 KB using Terser. Returns minified code and byte savings. Use when embedding scripts in HTML templates, report payloads, or injecting inline code programmatically.

minify_js input schema
{
  "type": "object",
  "examples": [
    {
      "code": "function add(a, b) {\n  return a + b;\n}"
    }
  ],
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "string",
      "description": "JavaScript code to minify (max 50kb)"
    }
  }
}
minify_js output schema
{
  "type": "object",
  "properties": {
    "minified": {}
  },
  "additionalProperties": true
}
minify_js annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
decode_jwt
Advertised by the server during the last successful anonymous check.
Advertised read-only

Decode a JWT (JSON Web Token) and return its header and payload without verifying the signature. Also reports whether the token is expired and the exact expiry date. Use to inspect claims (sub, iss, exp, roles) during debugging or when integrating with an auth provider.

decode_jwt input schema
{
  "type": "object",
  "examples": [
    {
      "token": "eyJhbGciOiJIUzI1NiJ9.eyJleHAiOjQxMDI0NDQ4MDB9.sig"
    }
  ],
  "required": [
    "token"
  ],
  "properties": {
    "token": {
      "type": "string",
      "description": "The JWT string to decode (header.payload.signature)"
    }
  }
}
decode_jwt output schema
{
  "type": "object",
  "properties": {
    "note": {
      "type": "string"
    },
    "header": {},
    "expired": {},
    "payload": {},
    "expiresAt": {}
  },
  "additionalProperties": true
}
decode_jwt annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
timestamp_convert
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert between Unix timestamps (seconds or milliseconds) and ISO-8601 / UTC date strings. Auto-detects epoch vs. millisecond format. Omit input to get the current time. Returns iso, unix_s, unix_ms, utc, date, and time fields.

timestamp_convert input schema
{
  "type": "object",
  "examples": [
    {
      "input": 0
    }
  ],
  "properties": {
    "input": {
      "description": "Unix timestamp (number, seconds or ms) or ISO date string. Omit to get the current time."
    }
  }
}
timestamp_convert output schema
{
  "type": "object",
  "properties": {
    "iso": {
      "type": "string"
    },
    "utc": {
      "type": "string"
    },
    "date": {
      "type": "string"
    },
    "time": {
      "type": "string"
    },
    "unix_s": {
      "type": "number"
    },
    "unix_ms": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
timestamp_convert annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
validate_url
Advertised by the server during the last successful anonymous check.
Advertised read-only

Parse and validate a URL. Returns decomposed components: protocol, hostname, port, path, query parameters, hash, and origin.

validate_url input schema
{
  "type": "object",
  "examples": [
    {
      "input": "https://www.ia-qa.com/mcp?x=1#y"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "URL to validate and parse"
    }
  }
}
validate_url output schema
{
  "type": "object",
  "properties": {
    "full": {},
    "hash": {},
    "port": {},
    "valid": {
      "type": "boolean"
    },
    "origin": {},
    "search": {},
    "hostname": {},
    "pathname": {},
    "protocol": {},
    "query_params": {}
  },
  "additionalProperties": true
}
validate_url annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
check_contrast_ratio
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calculate WCAG 2.1 contrast ratio between two colors. Returns ratio and compliance for AA/AAA normal and large text.

check_contrast_ratio input schema
{
  "type": "object",
  "examples": [
    {
      "background": "#fff",
      "foreground": "#000"
    }
  ],
  "required": [
    "foreground",
    "background"
  ],
  "properties": {
    "background": {
      "type": "string",
      "description": "Background color in hex (e.g., \"#ffffff\")"
    },
    "foreground": {
      "type": "string",
      "description": "Foreground color in hex (e.g., \"#333333\")"
    }
  }
}
check_contrast_ratio output schema
{
  "type": "object",
  "properties": {
    "ratio": {},
    "AA_large": {
      "type": "boolean"
    },
    "AAA_large": {
      "type": "boolean"
    },
    "AA_normal": {
      "type": "boolean"
    },
    "AAA_normal": {
      "type": "boolean"
    },
    "background": {
      "type": "object"
    },
    "foreground": {
      "type": "object"
    },
    "ratio_text": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
check_contrast_ratio annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
cron_parse
Advertised by the server during the last successful anonymous check.
Advertised read-only

Parse a cron expression into a human-readable schedule description. Supports standard 5-field cron (minute hour day month weekday).

cron_parse input schema
{
  "type": "object",
  "examples": [
    {
      "expression": "*/5 * * * *"
    }
  ],
  "required": [
    "expression"
  ],
  "properties": {
    "expression": {
      "type": "string",
      "description": "Cron expression (e.g., \"0 9 * * 1-5\", \"*/15 * * * *\")"
    }
  }
}
cron_parse output schema
{
  "type": "object",
  "properties": {
    "fields": {
      "type": "object"
    },
    "expression": {},
    "human_readable": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
cron_parse annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
cron_validator
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate a 5-field cron expression, explain the schedule, and preview the next execution times. Use this to debug cron jobs before they reach production. Returns parsed fields, a human-readable description, and upcoming ISO timestamps.

cron_validator input schema
{
  "type": "object",
  "examples": [
    {
      "expression": "0 0 29 2 *",
      "next_runs_count": 1
    }
  ],
  "required": [
    "expression"
  ],
  "properties": {
    "expression": {
      "type": "string",
      "description": "Cron expression with 5 fields, e.g. \"*/15 9-18 * * 1-5\""
    },
    "next_runs_count": {
      "type": "number",
      "description": "How many upcoming runs to return (1-50, default: 10)"
    }
  }
}
cron_validator output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "fields": {
      "type": "object"
    },
    "next_runs": {},
    "expression": {},
    "human_readable": {}
  },
  "additionalProperties": true
}
cron_validator annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
http_status_lookup
Advertised by the server during the last successful anonymous check.
Advertised read-only

Look up detailed information about any HTTP status code: class, name, description, cacheability, typical causes, and handling best practices. Covers every code in the IANA HTTP Status Code Registry (1xx-5xx, including 226, 425, 451, 508, 511 and the WebDAV codes) with its defining RFC; anything outside the registry is reported as `registered: false` rather than described. `cacheable` means heuristically cacheable by default per RFC 9110 §15.1.

http_status_lookup input schema
{
  "type": "object",
  "examples": [
    {
      "code": 418
    }
  ],
  "required": [
    "code"
  ],
  "properties": {
    "code": {
      "type": "number",
      "description": "HTTP status code (e.g. 200, 404, 429, 503)"
    }
  }
}
http_status_lookup output schema
{
  "type": "object",
  "properties": {
    "code": {},
    "desc": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "class": {},
    "cacheable": {},
    "registered": {
      "type": "boolean"
    },
    "description": {}
  },
  "additionalProperties": true
}
http_status_lookup annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
parse_http_headers
Advertised by the server during the last successful anonymous check.
Advertised read-only

Parse a raw HTTP headers block into a structured JSON object. Detects multi-value headers, masks Authorization values, and optionally audits for missing security headers (HSTS, CSP, X-Frame-Options, etc.).

parse_http_headers input schema
{
  "type": "object",
  "examples": [
    {
      "headers": "Content-Type: text/html\nSet-Cookie: a=1\nSet-Cookie: b=2"
    }
  ],
  "required": [
    "headers"
  ],
  "properties": {
    "headers": {
      "type": "string",
      "description": "Raw HTTP headers (one \"Name: Value\" per line)"
    },
    "analyze_security": {
      "type": "boolean",
      "description": "Audit for missing security headers (default: true)"
    }
  }
}
parse_http_headers output schema
{
  "type": "object",
  "properties": {
    "parsed": {
      "type": "object"
    },
    "security": {
      "type": "object"
    },
    "header_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
parse_http_headers annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_curl
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate a curl command from request parameters. Supports GET/POST/PUT/DELETE, custom headers, JSON body, and form data. Useful for documentation, sharing, and debugging API calls.

generate_curl input schema
{
  "type": "object",
  "examples": [
    {
      "url": "https://x.com",
      "method": "DELETE"
    }
  ],
  "required": [
    "url"
  ],
  "properties": {
    "url": {
      "type": "string",
      "description": "Request URL (must be http/https)"
    },
    "body": {
      "type": "string",
      "description": "Raw request body string"
    },
    "method": {
      "type": "string",
      "description": "HTTP method (default: GET)"
    },
    "headers": {
      "type": "object",
      "description": "Request headers as key-value object",
      "additionalProperties": true
    },
    "verbose": {
      "type": "boolean",
      "description": "Add -v for verbose output (default: false)"
    },
    "body_json": {
      "type": "object",
      "description": "JSON body (auto-adds Content-Type: application/json)",
      "additionalProperties": true
    },
    "follow_redirects": {
      "type": "boolean",
      "description": "Follow redirects with -L flag (default: true)"
    }
  }
}
generate_curl output schema
{
  "type": "object",
  "properties": {
    "url": {},
    "curl": {
      "type": "string"
    },
    "method": {},
    "header_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
generate_curl annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
extract_todos
Advertised by the server during the last successful anonymous check.
Advertised read-only

Extract TODO, FIXME, HACK, BUG, NOTE, OPTIMIZE, and custom tags from any source code or text. Returns line numbers, tag types, and message text. Essential for technical debt auditing.

extract_todos input schema
{
  "type": "object",
  "examples": [
    {
      "input": "// todo: refactor\n// todo(jc): rename"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "tags": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Custom tags to add (default set: TODO, FIXME, HACK, NOTE, BUG, OPTIMIZE, XXX)"
    },
    "input": {
      "type": "string",
      "description": "Code or text to scan"
    },
    "include_context": {
      "type": "boolean",
      "description": "Include full line text (default: true)"
    }
  }
}
extract_todos output schema
{
  "type": "object",
  "properties": {
    "items": {},
    "total": {
      "type": "number"
    },
    "counts": {},
    "has_critical": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
extract_todos annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
detect_secrets
Advertised by the server during the last successful anonymous check.
Advertised read-only

Scan code or config files for hardcoded secrets: AWS keys, GitHub tokens, OpenAI/Anthropic API keys, Stripe secrets, JWTs, Slack/Teams/Discord webhook URLs, session cookies, database connection strings, and generic passwords. Returns findings with severity. Run before every commit.

detect_secrets input schema
{
  "type": "object",
  "examples": [
    {
      "input": "redis://cache:6379"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Code or config content to scan (max 500KB)"
    },
    "filename": {
      "type": "string",
      "description": "Optional filename for context (e.g. \".env\", \"config.js\")"
    }
  }
}
detect_secrets output schema
{
  "type": "object",
  "properties": {
    "filename": {},
    "findings": {},
    "risk_level": {},
    "recommendation": {},
    "total_findings": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
detect_secrets annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
count_code_lines
Advertised by the server during the last successful anonymous check.
Advertised read-only

Count lines of code: total, code lines, comment lines, blank lines, and comment density. Supports JS/TS, Python, Java/C/C++, Ruby, Go, Shell, HTML/XML, and CSS.

count_code_lines input schema
{
  "type": "object",
  "examples": [
    {
      "input": "// c\nconst a = 1; // x\n\n/* b\n c */\nlet b;",
      "language": "javascript"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Source code to analyze"
    },
    "language": {
      "type": "string",
      "description": "Language hint: \"js\", \"ts\", \"py\", \"java\", \"c\", \"rb\", \"go\", \"sh\", \"html\", \"css\" (auto-detect if omitted)"
    }
  }
}
count_code_lines output schema
{
  "type": "object",
  "properties": {
    "language": {},
    "code_lines": {},
    "blank_lines": {},
    "total_lines": {},
    "comment_lines": {},
    "comment_density": {},
    "code_to_comment_ratio": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
count_code_lines annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
lint_commit_message
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate a git commit message against the Conventional Commits spec (feat, fix, docs, style, refactor, test, chore, ci, perf, build). Returns compliance score, breaking change detection, and actionable suggestions.

lint_commit_message input schema
{
  "type": "object",
  "examples": [
    {
      "message": "feat!: drop node 18"
    }
  ],
  "required": [
    "message"
  ],
  "properties": {
    "strict": {
      "type": "boolean",
      "description": "Enforce strict rules: max 72-char subject, imperative mood check (default: false)"
    },
    "message": {
      "type": "string",
      "description": "Git commit message to validate"
    }
  }
}
lint_commit_message output schema
{
  "type": "object",
  "properties": {
    "type": {},
    "scope": {},
    "score": {
      "type": "number"
    },
    "valid": {
      "type": "boolean"
    },
    "checks": {},
    "subject": {},
    "has_body": {
      "type": "boolean"
    },
    "is_breaking_change": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
lint_commit_message annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
format_bytes
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert raw byte counts to human-readable sizes in SI (KB=1000) or IEC (KiB=1024) units, or parse size strings back to bytes. Covers B, KB/KiB, MB/MiB, GB/GiB, TB/TiB, PB/PiB.

format_bytes input schema
{
  "type": "object",
  "examples": [
    {
      "bytes": 1536,
      "standard": "iec"
    }
  ],
  "properties": {
    "bytes": {
      "type": "number",
      "description": "Number of bytes to format"
    },
    "standard": {
      "enum": [
        "both",
        "si",
        "iec"
      ],
      "type": "string",
      "description": "Output standard (default: both)"
    },
    "size_string": {
      "type": "string",
      "description": "Size string to parse to bytes (e.g. \"1.5 GB\", \"512 MiB\")"
    }
  }
}
format_bytes output schema
{
  "type": "object",
  "properties": {
    "bytes": {
      "type": "number"
    },
    "original": {}
  },
  "additionalProperties": true
}
format_bytes annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
pr_gatekeeper
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compound quality gate for pull requests. Runs three sequential checks: (1) secret detection — scans diff for API keys, tokens, passwords matching 16 regex patterns; (2) bug analysis — heuristic scan for eval(), innerHTML, empty catch, console.log, TODO/FIXME; (3) commit message linting against Conventional Commits spec. Returns gate verdict (PASS/WARN/BLOCK), blockers, and actionable warnings. Use before merging any code change.

pr_gatekeeper input schema
{
  "type": "object",
  "examples": [
    {
      "diff": "diff --git a/pay.js b/pay.js\n--- a/pay.js\n+++ b/pay.js\n@@ -1 +1 @@\n-if (amount > 0) charge(amount);\n+if (amount >= 0) charge(amount);",
      "commit_message": "fix(pay): accept a zero amount"
    }
  ],
  "required": [
    "diff",
    "commit_message"
  ],
  "properties": {
    "diff": {
      "type": "string",
      "description": "Unified git diff (output of `git diff HEAD`)"
    },
    "context": {
      "type": "string",
      "description": "Optional: PR title or description for richer bug analysis"
    },
    "commit_message": {
      "type": "string",
      "description": "The commit message to lint (e.g. \"feat(auth): add OAuth2 login\")"
    }
  }
}
pr_gatekeeper output schema
{
  "type": "object",
  "properties": {
    "flags": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "score": {
      "type": "number"
    },
    "checks": {
      "type": "object"
    },
    "verdict": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
pr_gatekeeper annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
webhook_endpoint_create
Advertised by the server during the last successful anonymous check.

Create a temporary webhook endpoint that captures incoming HTTP requests for one hour. Returns the webhook id, public URL, expiration timestamp, and current request count. Use together with webhook_endpoint_requests to inspect captured payloads.

webhook_endpoint_create input schema
{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "base_url": {
      "type": "string",
      "description": "Optional public base URL. Default: https://www.ia-qa.com/mcp/webhook (the apex ia-qa.com answers 301 and a redirected POST loses its body, so an apex base_url is normalized to www)"
    }
  }
}
webhook_endpoint_create output schema
{
  "type": "object",
  "properties": {
    "id": {},
    "url": {
      "type": "string"
    },
    "expires_at": {
      "type": "string"
    },
    "request_count": {
      "type": "number"
    },
    "retention_minutes": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
webhook_endpoint_create annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
webhook_endpoint_requests
Advertised by the server during the last successful anonymous check.
Advertised read-only

Fetch the requests captured by a webhook created with webhook_endpoint_create. Returns the newest requests first with method, headers, query params, body payload, and timestamps.

webhook_endpoint_requests input schema
{
  "type": "object",
  "examples": [
    {
      "id": "<id returned by webhook_endpoint_create>"
    }
  ],
  "required": [
    "id"
  ],
  "properties": {
    "id": {
      "type": "string",
      "description": "Webhook id returned by webhook_endpoint_create"
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of requests to return (1-100, default: 20)"
    }
  }
}
webhook_endpoint_requests output schema
{
  "type": "object",
  "properties": {
    "id": {
      "type": "string"
    },
    "requests": {
      "type": "array"
    },
    "expires_at": {
      "type": "string"
    },
    "request_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
webhook_endpoint_requests annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
env_parse
Advertised by the server during the last successful anonymous check.
Advertised read-only

Parse a .env file content into a JSON object. Handles quoted values (single and double), inline comments, export prefix, and escaped sequences (\n, \t inside double quotes). Returns all key-value pairs. Use in CI/CD pipelines, agent config loaders, or when processing dotenv files programmatically.

env_parse input schema
{
  "type": "object",
  "examples": [
    {
      "input": "PORT=3000"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": ".env file content to parse (e.g. the output of `cat .env`)"
    }
  }
}
env_parse output schema
{
  "type": "object",
  "properties": {
    "vars": {},
    "count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
env_parse annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
openapi_validate
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate the structure of an OpenAPI 3.x specification (JSON or YAML). Checks required top-level fields (openapi, info.title, info.version, paths), validates each operation (responses, operationId uniqueness), detects undeclared $ref components, and flags missing 2xx responses. Returns a PASS/FAIL verdict, a 0–100 compliance score, and a list of errors and warnings with JSON-pointer locations. Use before publishing an API spec or generating SDK code.

openapi_validate input schema
{
  "type": "object",
  "examples": [
    {
      "input": {
        "info": {
          "title": "t",
          "version": "1"
        },
        "paths": {
          "/a": {
            "get": {
              "responses": {
                "200": {
                  "description": "ok"
                }
              },
              "operationId": "getA"
            }
          }
        },
        "openapi": "3.0.3"
      }
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The OpenAPI 3.x spec — a JSON string, a YAML string, or the already-parsed spec object."
    }
  }
}
openapi_validate output schema
{
  "type": "object",
  "properties": {
    "score": {
      "type": "number"
    },
    "stats": {
      "type": "object"
    },
    "errors": {},
    "verdict": {},
    "warnings": {}
  },
  "additionalProperties": true
}
openapi_validate annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_slug
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert any string into a URL-friendly slug: lowercase, ASCII-normalized (é→e), special characters removed, spaces replaced with hyphens. Use for generating SEO-friendly URL paths, file names, or identifier keys from user-provided titles or labels.

generate_slug input schema
{
  "type": "object",
  "examples": [
    {
      "input": "Héllo Wörld 2026"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "String to slugify"
    },
    "separator": {
      "type": "string",
      "description": "Separator character (default: \"-\")"
    }
  }
}
generate_slug output schema
{
  "type": "object",
  "properties": {
    "slug": {}
  },
  "additionalProperties": true
}
generate_slug annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
fetch_veille_feed
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Fetch the latest QA & AI/LLM articles aggregated from curated RSS sources (Google Testing Blog, DEV.to Testing/QA/AI/LLM/Agents, Hugging Face Blog, Simon Willison). Perfect for agents monitoring the QA & AI landscape. Each article carries summary_source — the XML tag the summary was read from, or "none" when the feed publishes titles and links only; an empty summary with summary_source "none" is a property of that feed, not a parse failure.

fetch_veille_feed input schema
{
  "type": "object",
  "examples": [
    {}
  ],
  "properties": {
    "limit": {
      "type": "number",
      "description": "Max articles to return (default: 20, max: 50)"
    },
    "category": {
      "type": "string",
      "description": "Filter: \"qa\" (testing/quality), \"ai\" (AI/LLM/agents), \"all\" (default — both)"
    }
  }
}
fetch_veille_feed output schema
{
  "type": "object",
  "properties": {
    "articles": {
      "type": "array"
    },
    "category": {},
    "total_found": {
      "type": "number"
    },
    "sources_queried": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
fetch_veille_feed annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
score_geo_signals
Advertised by the server during the last successful anonymous check.
Advertised read-only

Analyze a webpage <head> HTML (or full HTML) for GEO (Generative Engine Optimization) signals. Returns a score /60 with per-check results and improvement tips. GEO = optimizing pages for AI-powered search engines (ChatGPT Search, Perplexity, etc.).

score_geo_signals input schema
{
  "type": "object",
  "examples": [
    {
      "head_html": "<head><title>Refund policy | Shop</title><meta name=\"description\" content=\"How refunds work at Shop.\"></head>"
    }
  ],
  "required": [
    "head_html"
  ],
  "properties": {
    "head_html": {
      "type": "string",
      "description": "Raw HTML of the <head> section (or full page HTML) to analyze"
    }
  }
}
score_geo_signals output schema
{
  "type": "object",
  "properties": {
    "grade": {},
    "score": {},
    "checks": {},
    "passed": {
      "type": "number"
    },
    "max_score": {
      "type": "number"
    },
    "total_checks": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
score_geo_signals annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
latency_benchmark
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

Measure response time of one or more HTTP endpoints (GET/POST). Runs N iterations and returns min/max/avg/p95 latency. Useful for API and MCP server benchmarking.

latency_benchmark input schema
{
  "type": "object",
  "examples": [
    {
      "endpoints": "https://www.ia-qa.com/mcp/ping",
      "iterations": 3
    }
  ],
  "required": [
    "endpoints"
  ],
  "properties": {
    "endpoints": {
      "type": [
        "string",
        "array"
      ],
      "items": {
        "type": "object",
        "properties": {
          "url": {
            "type": "string",
            "description": "Full URL to test"
          },
          "body": {
            "type": "object",
            "description": "Request body for POST",
            "additionalProperties": true
          },
          "label": {
            "type": "string",
            "description": "Optional label for this endpoint"
          },
          "method": {
            "enum": [
              "GET",
              "POST"
            ],
            "type": "string",
            "description": "HTTP method (default: GET)"
          },
          "headers": {
            "type": "object",
            "description": "Custom headers",
            "additionalProperties": true
          }
        }
      },
      "description": "Endpoints to benchmark. Accepts a single URL string, an array of URL strings, or an array of {url, method?, body?, headers?, label?} objects."
    },
    "iterations": {
      "type": "number",
      "description": "Number of iterations per endpoint (default: 3, max: 10)"
    }
  }
}
latency_benchmark output schema
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object"
      }
    },
    "iterations": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
latency_benchmark annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
format_json
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate and pretty-print a string that is ALREADY valid JSON. Strict by design — it is a validity gate: valid JSON comes back formatted, anything else is rejected with the exact parse error. It never repairs, completes, or guesses. NOT for: plain text or prose (will fail), JSON embedded in markdown/prose (use extract_json_from_text first), JS objects (JSON.stringify them first), YAML (use yaml_to_json).

format_json input schema
{
  "type": "object",
  "examples": [
    {
      "input": "{\"a\":1,\"b\":{\"a\":2}}"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "A raw JSON string, e.g. '{\"key\":\"value\"}'. Must already parse as JSON — plain text or truncated JSON is rejected, not repaired."
    },
    "indent": {
      "type": "number",
      "description": "Indent size (default: 2)"
    }
  }
}
format_json output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "formatted": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
format_json annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
parse_csv
Advertised by the server during the last successful anonymous check.
Advertised read-only

Parse a CSV string into a JSON array of objects (or raw arrays). Full RFC 4180: quoted fields may contain the delimiter, embedded newlines (the Excel/Sheets multi-line cell), and doubled quotes. Custom delimiters supported. An unterminated quote is rejected with its position rather than parsed into corrupted rows. Use when processing spreadsheet exports, data imports, or structured text pipelines where the source is CSV. Supports up to 200 KB.

parse_csv input schema
{
  "type": "object",
  "examples": [
    {
      "input": "a;b\n1;2",
      "delimiter": ";"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "CSV content to parse"
    },
    "header": {
      "type": "boolean",
      "description": "Treat the first row as headers (default: true)"
    },
    "delimiter": {
      "type": "string",
      "description": "Field delimiter character (default: \",\")"
    }
  }
}
parse_csv output schema
{
  "type": "object",
  "properties": {
    "rows": {
      "type": "array"
    },
    "columns": {
      "type": "number"
    },
    "headers": {
      "type": "array"
    },
    "row_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
parse_csv annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
extract_json_path
Advertised by the server during the last successful anonymous check.
Advertised read-only

Extract a value from a JSON string using dot-notation path (e.g., "user.address.city", "items.0.name", "meta.tags"). Supports array index access via numeric path segments.

extract_json_path input schema
{
  "type": "object",
  "examples": [
    {
      "path": "a.b.0.c",
      "input": {
        "a": {
          "b": [
            {
              "c": 1
            },
            {
              "c": 2
            }
          ]
        }
      }
    }
  ],
  "required": [
    "input",
    "path"
  ],
  "properties": {
    "path": {
      "type": "string",
      "description": "Dot-notation path, e.g. \"user.address.city\" or \"items.0.name\""
    },
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON to traverse — a JSON string, or the object/array itself."
    }
  }
}
extract_json_path output schema
{
  "type": "object",
  "properties": {
    "path": {},
    "type": {},
    "value": {}
  },
  "additionalProperties": true
}
extract_json_path annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_json_ld
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate a ready-to-paste <script type="application/ld+json"> snippet for GEO / structured data optimization. Supported types: WebSite, FAQPage, Article, Person, Organization, SoftwareApplication, HowTo.

generate_json_ld input schema
{
  "type": "object",
  "examples": [
    {
      "type": "FAQPage",
      "faq_items": [
        {
          "answer": "A.",
          "question": "Q?"
        }
      ]
    }
  ],
  "required": [
    "type"
  ],
  "properties": {
    "type": {
      "type": "string",
      "description": "Schema @type: \"WebSite\", \"FAQPage\", \"Article\", \"Person\", \"Organization\", \"SoftwareApplication\", \"HowTo\""
    },
    "fields": {
      "type": "object",
      "description": "Schema fields as key-value pairs (name, url, description, author, datePublished, etc.)",
      "additionalProperties": true
    },
    "faq_items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "answer": {
            "type": "string"
          },
          "question": {
            "type": "string"
          }
        }
      },
      "description": "For FAQPage/HowTo: array of { question, answer } objects"
    }
  }
}
generate_json_ld output schema
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string"
    },
    "schema": {},
    "snippet": {
      "type": "string"
    },
    "acceptedAnswer": {
      "type": "object"
    }
  },
  "additionalProperties": true
}
generate_json_ld annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
json_schema_validate
Advertised by the server during the last successful anonymous check.
Advertised read-only

Validate a JSON value against a JSON Schema (draft-07 subset). Supports type, required, properties, items, enum, const, pattern, format (email/uri/date/date-time/uuid), minimum/maximum, minLength/maxLength, minItems/maxItems, uniqueItems, additionalProperties, anyOf, allOf, oneOf, not, and local $ref (#/definitions/…, #/$defs/…). A schema using a keyword outside that list (patternProperties, if/then, dependencies, a remote $ref…) is never reported valid: the keyword is named in `unevaluated_keywords`. Returns all validation errors with dot-notation paths.

json_schema_validate input schema
{
  "type": "object",
  "examples": [
    {
      "value": {
        "p": {
          "n": "five"
        }
      },
      "schema": {
        "type": "object",
        "$defs": {
          "P": {
            "type": "object",
            "properties": {
              "n": {
                "type": "string"
              }
            }
          }
        },
        "properties": {
          "p": {
            "$ref": "#/$defs/P"
          }
        }
      }
    }
  ],
  "required": [
    "value",
    "schema"
  ],
  "properties": {
    "value": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON value to validate — a JSON string, or the value itself."
    },
    "schema": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON Schema — a JSON string, or the schema object itself."
    }
  }
}
json_schema_validate output schema
{
  "type": "object",
  "properties": {
    "valid": {
      "type": "boolean"
    },
    "errors": {
      "type": "array"
    },
    "error_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
json_schema_validate annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
flatten_json
Advertised by the server during the last successful anonymous check.
Advertised read-only

Flatten a nested JSON object to single-level dot-notation keys (e.g. {"a":{"b":1}} → {"a.b":1}), or unflatten dot-notation keys back to a nested object. Supports custom separators.

flatten_json input schema
{
  "type": "object",
  "examples": [
    {
      "input": {
        "a": {
          "b": 1,
          "c": [
            1,
            2
          ]
        }
      }
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "mode": {
      "type": "string",
      "description": "\"flatten\" (default) or \"unflatten\""
    },
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON to flatten or unflatten — a JSON string, or the object itself."
    },
    "separator": {
      "type": "string",
      "description": "Key separator (default: \".\")"
    }
  }
}
flatten_json output schema
{
  "type": "object",
  "properties": {
    "result": {},
    "key_count": {
      "type": "number"
    },
    "max_depth": {
      "type": "array"
    }
  },
  "additionalProperties": true
}
flatten_json annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
xml_to_json
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert an XML string to a JSON object. Supports attributes, nested elements, arrays, CDATA, and namespaces. Options: parse numbers, parse booleans, ignore attributes.

xml_to_json input schema
{
  "type": "object",
  "examples": [
    {
      "input": "<r a=\"1\"><i>x</i><i>y</i></r>"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "XML string to convert"
    },
    "attr_prefix": {
      "type": "string",
      "description": "Prefix for attribute keys (default: \"@_\")"
    },
    "ignore_attrs": {
      "type": "boolean",
      "description": "Ignore XML attributes (default: false)"
    },
    "parse_values": {
      "type": "boolean",
      "description": "Auto-parse numbers and booleans (default: true)"
    }
  }
}
xml_to_json output schema
{
  "type": "object",
  "properties": {
    "result": {},
    "key_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
xml_to_json annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
mock_from_schema
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate realistic mock data from a JSON Schema. Supports all common types (string, number, integer, boolean, array, object, null), format hints (email, date, date-time, uri, uuid), enum, const, and nested schemas. Perfect for testing MCP tools with realistic data.

mock_from_schema input schema
{
  "type": "object",
  "examples": [
    {
      "count": 20,
      "schema": {
        "type": "object",
        "required": [
          "id",
          "email"
        ],
        "properties": {
          "id": {
            "type": "integer",
            "maximum": 9,
            "minimum": 5
          },
          "tag": {
            "enum": [
              "a",
              "b"
            ]
          },
          "email": {
            "type": "string",
            "format": "email"
          }
        }
      }
    }
  ],
  "required": [
    "schema"
  ],
  "properties": {
    "seed": {
      "type": "string",
      "description": "Optional seed string for deterministic output (uses first char codes)"
    },
    "count": {
      "type": "number",
      "description": "Number of mock objects to generate (default: 1, max: 20)"
    },
    "schema": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON Schema to generate from — a JSON string, or the schema object itself."
    }
  }
}
mock_from_schema output schema
{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "results": {}
  },
  "additionalProperties": true
}
mock_from_schema annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
transform_json_array
Advertised by the server during the last successful anonymous check.
Advertised read-only

Transform a JSON array using common operations: pluck (extract specific fields), filter (by field value), sort_by (field), group_by (field), count_by (field), uniq_by (field). Useful for processing MCP tool results and LLM structured outputs.

transform_json_array input schema
{
  "type": "object",
  "examples": [
    {
      "field": "v",
      "input": [
        {
          "v": 2
        },
        {
          "v": 10
        },
        {
          "v": 1
        }
      ],
      "operation": "sort_by",
      "sort_order": "desc"
    }
  ],
  "required": [
    "input",
    "operation"
  ],
  "properties": {
    "n": {
      "type": "number",
      "description": "For first_n / last_n: number of items"
    },
    "path": {
      "type": "string",
      "description": "Optional dot-notation path to the array within the JSON object (e.g. \"data.items\")"
    },
    "field": {
      "type": "string",
      "description": "Field to operate on (for sort_by, group_by, count_by, uniq_by, filter)"
    },
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON containing an array (or an object with an array at `path`) — a JSON string, or the value itself."
    },
    "fields": {
      "type": "string",
      "description": "Comma-separated field list for \"pluck\" (e.g. \"id,name,email\")"
    },
    "filter_op": {
      "type": "string",
      "description": "For \"filter\": \"==\" | \"!=\" | \">\" | \">=\" | \"<\" | \"<=\" | \"contains\" | \"exists\" | \"!exists\""
    },
    "operation": {
      "type": "string",
      "description": "Operation: \"pluck\", \"filter\", \"sort_by\", \"group_by\", \"count_by\", \"uniq_by\", \"reverse\", \"first_n\", \"last_n\", \"flatten\""
    },
    "sort_order": {
      "type": "string",
      "description": "For sort_by: \"asc\" (default) or \"desc\""
    },
    "filter_value": {
      "type": "string",
      "description": "For \"filter\": value to compare against"
    }
  }
}
transform_json_array output schema
{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "field": {},
    "order": {},
    "total": {
      "type": "number"
    },
    "fields": {},
    "result": {},
    "removed": {
      "type": "number"
    },
    "operation": {
      "type": "string"
    },
    "group_count": {
      "type": "number"
    },
    "unique_values": {
      "type": "number"
    },
    "removed_duplicates": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
transform_json_array annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
json_to_csv
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert a JSON array of objects to CSV format. Automatically detects columns from all object keys. Handles quoting and escaping per RFC 4180.

json_to_csv input schema
{
  "type": "object",
  "examples": [
    {
      "input": [
        {
          "a": 1
        },
        {
          "b": 2
        }
      ]
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The array of objects to convert — a JSON string, or the array itself."
    },
    "headers": {
      "type": "boolean",
      "description": "Include header row (default: true)"
    },
    "delimiter": {
      "type": "string",
      "description": "Column delimiter (default: \",\")"
    }
  }
}
json_to_csv output schema
{
  "type": "object",
  "properties": {
    "csv": {
      "type": "string"
    },
    "rows": {
      "type": "number"
    },
    "columns": {
      "type": "number"
    },
    "column_names": {}
  },
  "additionalProperties": true
}
json_to_csv annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
json_diff
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute a deep structural diff between two JSON values. Returns added, removed, and changed keys with dot-notation paths. Like git diff but for JSON objects — perfect for API response regression testing. Arrays are not compared blindly by position: the same elements in a different order collapse to a single "reordered" change, and an array of records sharing a stable identity field (id, uuid, key, name…) is matched by that field, so paths read [id=42] and a moved record is not reported as N rewrites.

json_diff input schema
{
  "type": "object",
  "examples": [
    {
      "after": {
        "a": 1,
        "b": 2
      },
      "before": {
        "a": 1,
        "b": 2
      }
    }
  ],
  "required": [
    "before",
    "after"
  ],
  "properties": {
    "after": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The modified JSON (after) — a JSON string, or the value itself."
    },
    "before": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The original JSON (before) — a JSON string, or the value itself."
    },
    "max_depth": {
      "type": "number",
      "description": "Max nesting depth to recurse (default: 10)"
    }
  }
}
json_diff output schema
{
  "type": "object",
  "properties": {
    "added": {
      "type": "boolean"
    },
    "changes": {
      "type": "array"
    },
    "removed": {
      "type": "boolean"
    },
    "modified": {
      "type": "boolean"
    },
    "identical": {
      "type": "boolean"
    },
    "total_changes": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
json_diff annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
merge_json
Advertised by the server during the last successful anonymous check.
Advertised read-only

Deep merge two JSON objects. Supports three array strategies: replace (default), concat, or unique (dedup concat). Nested objects are recursively merged — override takes precedence for primitives.

merge_json input schema
{
  "type": "object",
  "examples": [
    {
      "base": {
        "a": {
          "x": 1,
          "y": 2
        }
      },
      "override": {
        "a": {
          "y": 3
        }
      }
    }
  ],
  "required": [
    "base",
    "override"
  ],
  "properties": {
    "base": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The base JSON object (merged into) — a JSON string, or the object itself."
    },
    "override": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The override JSON object (takes precedence) — a JSON string, or the object itself."
    },
    "array_strategy": {
      "enum": [
        "replace",
        "concat",
        "unique"
      ],
      "type": "string",
      "description": "Array merge strategy: replace (default), concat, or unique"
    }
  }
}
merge_json output schema
{
  "type": "object",
  "properties": {
    "merged": {},
    "new_keys": {
      "type": "array"
    },
    "total_keys": {
      "type": "number"
    },
    "overridden_keys": {
      "type": "array"
    }
  },
  "additionalProperties": true
}
merge_json annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
json_to_yaml
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert a JSON object to clean, human-readable YAML. Handles nested objects, arrays, multiline strings, and special characters. No external dependencies.

json_to_yaml input schema
{
  "type": "object",
  "examples": [
    {
      "input": {
        "a": "x: y",
        "c": null,
        "d": "yes",
        "e": "0123"
      }
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The JSON to convert to YAML — a JSON string, or the value itself."
    },
    "indent": {
      "type": "number",
      "description": "Indentation size in spaces (default: 2)"
    }
  }
}
json_to_yaml output schema
{
  "type": "object",
  "properties": {
    "yaml": {},
    "lines": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
json_to_yaml annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
yaml_to_json
Advertised by the server during the last successful anonymous check.
Advertised read-only

Parse a YAML string and return the equivalent JSON value. The reverse of json_to_yaml. Supports nested objects, arrays, anchors, aliases, multi-document streams, and all scalar types. Use when processing config files, CI/CD pipeline definitions, or OpenAPI specs authored in YAML.

yaml_to_json input schema
{
  "type": "object",
  "examples": [
    {
      "input": "a: 1\nb: [x, y]"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "YAML string to parse"
    },
    "multi": {
      "type": "boolean",
      "description": "If true, parse all documents in a multi-document stream and return an array (default: false)"
    }
  }
}
yaml_to_json output schema
{
  "type": "object",
  "properties": {
    "json": {},
    "count": {
      "type": "number"
    },
    "documents": {}
  },
  "additionalProperties": true
}
yaml_to_json annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
json_schema_generate
Advertised by the server during the last successful anonymous check.
Advertised read-only

Infer a JSON Schema (draft-07) from a sample JSON value. Detects types, required fields, array item shapes, nested objects, and common string formats (email, uri, date, date-time, uuid). Returns a ready-to-use schema compatible with json_schema_validate. Use when you have a sample API response or LLM output and want to auto-generate a validation schema for CI/CD testing.

json_schema_generate input schema
{
  "type": "object",
  "examples": [
    {
      "input": {
        "a": [
          1
        ],
        "b": true,
        "f": 1.5,
        "n": 1,
        "o": {
          "k": null
        },
        "s": "x"
      }
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The sample JSON value to infer the schema from — a JSON string, or the value itself."
    },
    "samples": {
      "type": [
        "array",
        "string"
      ],
      "description": "More samples of the same shape, merged with input: a field seen as null and as a date becomes [\"string\",\"null\"]; one missing somewhere is not required."
    },
    "required_all": {
      "type": "boolean",
      "description": "Mark fields present in every observed object as required (default: true)"
    }
  }
}
json_schema_generate output schema
{
  "type": "object",
  "properties": {
    "schema": {
      "type": "object"
    },
    "warnings": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "additionalProperties": true
}
json_schema_generate annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
format_table
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert a JSON array of objects into a Markdown table. Automatically detects columns, aligns headers, and fills missing keys with empty cells. Use when an agent needs to present structured data — tool results, model comparisons, test reports — as a readable table in a response or document.

format_table input schema
{
  "type": "object",
  "examples": [
    {
      "input": [
        {
          "a": 1
        }
      ]
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": [
        "string",
        "object",
        "array"
      ],
      "description": "The array of objects to render — a JSON string, or the array itself."
    },
    "columns": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Column names and order (default: all keys from first row)"
    }
  }
}
format_table output schema
{
  "type": "object",
  "properties": {
    "rows": {
      "type": "number"
    },
    "table": {
      "type": "string"
    },
    "columns": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
format_table annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
text_stats
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute comprehensive statistics for any text: character count (with and without spaces), word count, line count, sentence count, paragraph count, and estimated reading time in minutes. Sentence counting is abbreviation-aware — titles (Mr., Dr.), acronyms (U.S., i.e., p.m.), initials, decimals, URLs and emails do not end a sentence, and a text with no terminal punctuation still counts as one. Use for validating form field lengths, evaluating LLM output verbosity, or content auditing.

text_stats input schema
{
  "type": "object",
  "examples": [
    {
      "input": "One two three.\nFour five!\n\nSix?"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "The text to analyse"
    }
  }
}
text_stats output schema
{
  "type": "object",
  "properties": {
    "chars": {},
    "lines": {},
    "words": {},
    "sentences": {},
    "paragraphs": {},
    "chars_no_space": {},
    "reading_time_minutes": {}
  },
  "additionalProperties": true
}
text_stats annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
regex_test
Advertised by the server during the last successful anonymous check.
Advertised read-only

Test a regular expression pattern against an input string and return all matches with their index positions and named capture groups. Use for validating user inputs, extracting structured data from text, or debugging regex patterns. Supports flags g, i, m, s, u, y. The match runs in an isolated thread with a 500 ms budget: a pattern that blows up (catastrophic backtracking, e.g. "(a+)+$") comes back as redos_detected:true — a real ReDoS verdict on your pattern — instead of hanging.

regex_test input schema
{
  "type": "object",
  "examples": [
    {
      "flags": "g",
      "input": "a 12-34 b 5-6",
      "pattern": "\\d+-\\d+"
    }
  ],
  "required": [
    "pattern",
    "input"
  ],
  "properties": {
    "flags": {
      "type": "string",
      "description": "Regex flags: g (global), i (case-insensitive), m (multiline), s (dotAll) — default: \"\""
    },
    "input": {
      "type": "string",
      "description": "The string to test against (max 50 KB)"
    },
    "pattern": {
      "type": "string",
      "description": "Regular expression pattern (without delimiters)"
    }
  }
}
regex_test output schema
{
  "type": "object",
  "properties": {
    "note": {},
    "flags": {},
    "matched": {},
    "matches": {},
    "pattern": {},
    "verdict": {},
    "elapsed_ms": {
      "type": "number"
    },
    "match_count": {
      "type": "number"
    },
    "redos_detected": {
      "type": "boolean"
    }
  },
  "additionalProperties": true
}
regex_test annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
lorem_ipsum
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate Lorem Ipsum placeholder text for UI mockups, design prototypes, or test data population. Configurable paragraphs (1–10), sentences per paragraph (1–20), and approximate words per sentence (3–30).

lorem_ipsum input schema
{
  "type": "object",
  "examples": [
    {
      "paragraphs": 3,
      "sentences_per_paragraph": 2
    }
  ],
  "properties": {
    "paragraphs": {
      "type": "number",
      "description": "Number of paragraphs to generate (1–10, default: 1)"
    },
    "words_per_sentence": {
      "type": "number",
      "description": "Approximate words per sentence (3–30, default: 10)"
    },
    "sentences_per_paragraph": {
      "type": "number",
      "description": "Sentences per paragraph (1–20, default: 5)"
    }
  }
}
lorem_ipsum output schema
{
  "type": "object",
  "properties": {
    "paragraphs": {},
    "paragraph_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
lorem_ipsum annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
strip_markdown
Advertised by the server during the last successful anonymous check.
Advertised read-only

Strip all Markdown formatting (headers, bold, italic, code fences, links, lists) from text and return clean plain text. Run this before injecting scraped documentation, README files, or user content into an LLM prompt to eliminate redundant markup tokens and reduce cost.

strip_markdown input schema
{
  "type": "object",
  "examples": [
    {
      "input": "# Title\n**bold** and [link](http://x.com) and `code`\n- item"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Markdown text to convert to plain text"
    }
  }
}
strip_markdown output schema
{
  "type": "object",
  "properties": {
    "text": {},
    "original_length": {
      "type": "number"
    },
    "stripped_length": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
strip_markdown annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
escape_html
Advertised by the server during the last successful anonymous check.
Advertised read-only

Escape HTML special characters (&, <, >, ", ') to their safe HTML entities. ALWAYS call this before inserting any user-provided or LLM-generated content into an HTML template to prevent cross-site scripting (XSS) attacks.

escape_html input schema
{
  "type": "object",
  "examples": [
    {
      "input": "<a href=\"x\">'&'</a>"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "String to HTML-escape"
    }
  }
}
escape_html output schema
{
  "type": "object",
  "properties": {
    "escaped": {},
    "original_length": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
escape_html annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
unescape_html
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert HTML entities (&amp;, &lt;, &gt;, &quot;, &#x27;, and numeric &#NNN;) back to plain characters. Use when processing HTML-encoded text from APIs, email content, or legacy database fields before passing to an LLM or displaying to users.

unescape_html input schema
{
  "type": "object",
  "examples": [
    {
      "input": "&#128512; &#x1F600;"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "HTML-encoded string to unescape"
    }
  }
}
unescape_html output schema
{
  "type": "object",
  "properties": {
    "unescaped": {}
  },
  "additionalProperties": true
}
unescape_html annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
case_convert
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert a string between naming conventions: camelCase, PascalCase, snake_case, kebab-case, UPPER_SNAKE_CASE, dot.case, Title Case. Essential for code generation and refactoring.

case_convert input schema
{
  "type": "object",
  "examples": [
    {
      "to": "snake",
      "input": "helloWorld fooBar"
    }
  ],
  "required": [
    "input",
    "to"
  ],
  "properties": {
    "to": {
      "type": "string",
      "description": "Target case: \"camel\", \"pascal\", \"snake\", \"kebab\", \"upper_snake\", \"dot\", \"title\""
    },
    "input": {
      "type": "string",
      "description": "String to convert (e.g., \"myVariableName\", \"my-css-class\")"
    }
  }
}
case_convert output schema
{
  "type": "object",
  "properties": {
    "result": {},
    "from_words": {},
    "target_case": {}
  },
  "additionalProperties": true
}
case_convert annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
sort_lines
Advertised by the server during the last successful anonymous check.
Advertised read-only

Sort, deduplicate, reverse, or filter lines of text. Useful for cleaning import lists, dependencies, log files, and config entries.

sort_lines input schema
{
  "type": "object",
  "examples": [
    {
      "input": "b\na\nb\nc",
      "operation": "deduplicate"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "trim": {
      "type": "boolean",
      "description": "Trim whitespace from each line (default: true)"
    },
    "input": {
      "type": "string",
      "description": "Multi-line text to process"
    },
    "filter": {
      "type": "string",
      "description": "For \"filter\": keep lines containing this substring (case-insensitive)"
    },
    "operation": {
      "type": "string",
      "description": "\"sort\" (default), \"sort_desc\", \"reverse\", \"deduplicate\", \"unique_sort\", \"filter\""
    },
    "remove_empty": {
      "type": "boolean",
      "description": "Remove empty lines (default: true)"
    }
  }
}
sort_lines output schema
{
  "type": "object",
  "properties": {
    "result": {
      "type": "string"
    },
    "removed": {
      "type": "number"
    },
    "line_count": {
      "type": "number"
    },
    "original_count": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
sort_lines annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
html_to_markdown
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert HTML to clean Markdown. Strips scripts, styles, nav, ads, and comments. Converts headings, lists, links, images, code blocks. Ideal for preparing web content as LLM context.

html_to_markdown input schema
{
  "type": "object",
  "examples": [
    {
      "input": "<h1>T</h1><p>a <strong>b</strong> <a href=\"https://x.com\">c</a></p><ul><li>i</li></ul>"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "HTML string to convert"
    },
    "strip_links": {
      "type": "boolean",
      "description": "Strip link URLs, keep text only (default: false)"
    }
  }
}
html_to_markdown output schema
{
  "type": "object",
  "properties": {
    "markdown": {},
    "markdown_length": {
      "type": "number"
    },
    "original_length": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
html_to_markdown annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
calculate_readability
Advertised by the server during the last successful anonymous check.
Advertised read-only

Calculate readability scores: Flesch Reading Ease, Flesch-Kincaid Grade Level, Coleman-Liau Index, and Automated Readability Index. Useful for evaluating LLM output quality.

calculate_readability input schema
{
  "type": "object",
  "examples": [
    {
      "input": "The cat sat on the mat. The dog ran."
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to analyze for readability"
    }
  }
}
calculate_readability output schema
{
  "type": "object",
  "properties": {
    "level": {},
    "stats": {
      "type": "object"
    },
    "coleman_liau_index": {
      "type": "number"
    },
    "flesch_reading_ease": {},
    "flesch_kincaid_grade": {
      "type": "number"
    },
    "automated_readability_index": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
calculate_readability annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
normalize_whitespace
Advertised by the server during the last successful anonymous check.
Advertised read-only

Normalize whitespace: trim trailing spaces, collapse blank lines, normalize line endings (LF/CRLF), convert tabs to spaces. Useful for cleaning code, configs, and text before processing.

normalize_whitespace input schema
{
  "type": "object",
  "examples": [
    {
      "input": "a  \r\nb\t\r\n\r\n\r\n\r\nc",
      "trim_lines": true,
      "line_ending": "lf",
      "collapse_blanks": true,
      "max_blank_lines": 1
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to normalize"
    },
    "trim_file": {
      "type": "boolean",
      "description": "Trim leading/trailing blank lines (default: true)"
    },
    "trim_lines": {
      "type": "boolean",
      "description": "Trim trailing whitespace from each line (default: true)"
    },
    "line_ending": {
      "type": "string",
      "description": "\"lf\" (default), \"crlf\", or \"cr\""
    },
    "tab_to_spaces": {
      "type": "number",
      "description": "Convert tabs to N spaces (omit to keep tabs)"
    },
    "collapse_blanks": {
      "type": "boolean",
      "description": "Collapse runs of blank lines down to max_blank_lines (default: true)"
    },
    "max_blank_lines": {
      "type": "number",
      "description": "Blank lines to keep when collapsing, 0-10 (default: 2)"
    }
  }
}
normalize_whitespace output schema
{
  "type": "object",
  "properties": {
    "result": {},
    "line_ending": {},
    "original_length": {
      "type": "number"
    },
    "normalized_length": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
normalize_whitespace annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
word_frequency
Advertised by the server during the last successful anonymous check.
Advertised read-only

Analyze word frequency in text. Returns top N words with counts and percentages. Supports English stopword filtering. Useful for content analysis, keyword extraction, and LLM output analysis.

word_frequency input schema
{
  "type": "object",
  "examples": [
    {
      "input": "the cat and the hat and the bat",
      "top_n": 1,
      "remove_stopwords": false
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to analyze"
    },
    "top_n": {
      "type": "number",
      "description": "Return top N words (default: 20, max: 200)"
    },
    "min_length": {
      "type": "number",
      "description": "Minimum word length to include (default: 3)"
    },
    "remove_stopwords": {
      "type": "boolean",
      "description": "Remove common English stopwords (default: true)"
    }
  }
}
word_frequency output schema
{
  "type": "object",
  "properties": {
    "top_words": {
      "type": "array"
    },
    "total_words": {},
    "unique_words": {
      "type": "number"
    },
    "stopwords_removed": {}
  },
  "additionalProperties": true
}
word_frequency annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
extract_links
Advertised by the server during the last successful anonymous check.
Advertised read-only

Extract all URLs, email addresses, and domain names from text. Returns categorized and deduplicated results. Useful for content auditing, link checking, and web scraping validation.

extract_links input schema
{
  "type": "object",
  "examples": [
    {
      "input": "nothing here"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to extract links from"
    },
    "types": {
      "type": "array",
      "items": {
        "enum": [
          "url",
          "email",
          "domain"
        ],
        "type": "string"
      },
      "description": "Types to extract (default: all three)"
    }
  }
}
extract_links output schema
{
  "type": "object",
  "properties": {
    "total": {}
  },
  "additionalProperties": true
}
extract_links annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
levenshtein_distance
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute the Levenshtein (edit) distance and normalized similarity ratio between two strings. Supports batch comparison. Useful for fuzzy string matching, deduplication, and test result comparison.

levenshtein_distance input schema
{
  "type": "object",
  "examples": [
    {
      "a": "kitten",
      "b": "sitting"
    }
  ],
  "properties": {
    "a": {
      "type": "string",
      "description": "First string (single-pair mode)"
    },
    "b": {
      "type": "string",
      "description": "Second string (single-pair mode)"
    },
    "batch": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "a": {
            "type": "string"
          },
          "b": {
            "type": "string"
          }
        }
      },
      "description": "Batch of {a,b} pairs (max 50)"
    },
    "case_insensitive": {
      "type": "boolean",
      "description": "Ignore case differences (default: false)"
    }
  }
}
levenshtein_distance output schema
{
  "type": "object",
  "properties": {
    "a": {},
    "b": {},
    "mode": {
      "type": "string"
    },
    "count": {
      "type": "number"
    },
    "results": {},
    "distance": {},
    "similarity": {
      "type": "string"
    },
    "operations_needed": {}
  },
  "additionalProperties": true
}
levenshtein_distance annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
detect_language
Advertised by the server during the last successful anonymous check.
Advertised read-only

Detect the natural language of a text using n-gram frequency analysis and common word markers. Supports 15 languages: English, French, Spanish, German, Italian, Portuguese, Dutch, Russian, Chinese, Japanese, Korean, Arabic, Polish, Turkish, Swedish.

detect_language input schema
{
  "type": "object",
  "examples": [
    {
      "input": "Il rilascio è fallito perché la migrazione del database è scaduta dopo dieci minuti."
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to detect language from (min 20 chars for accuracy)"
    }
  }
}
detect_language output schema
{
  "type": "object",
  "properties": {
    "lang": {},
    "name": {
      "type": "string"
    },
    "score": {},
    "method": {
      "type": "string"
    },
    "matched": {},
    "language": {
      "type": "string"
    },
    "confidence": {
      "type": "number"
    },
    "top_candidates": {
      "type": "array"
    }
  },
  "additionalProperties": true
}
detect_language annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_uuid
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate one or more cryptographically random UUID v4 identifiers. Use this when you need unique IDs for test fixtures, database records, session tokens, or any scenario requiring a guaranteed-unique string. Returns up to 100 UUIDs in one call.

generate_uuid input schema
{
  "type": "object",
  "examples": [
    {
      "count": 5
    }
  ],
  "properties": {
    "count": {
      "type": "number",
      "description": "Number of UUIDs to generate (1–100, default: 1)"
    }
  }
}
generate_uuid output schema
{
  "type": "object",
  "properties": {
    "count": {
      "type": "number"
    },
    "uuids": {}
  },
  "additionalProperties": true
}
generate_uuid annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
hash_text
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute a cryptographic hash of a text string. Use when you need to verify data integrity, generate content fingerprints, hash passwords (prefer SHA-256+), or produce a fixed-length digest of any input. Supports SHA-256 (default), SHA-512, SHA-1, and MD5.

hash_text input schema
{
  "type": "object",
  "examples": [
    {
      "input": "héllo wörld 🌍",
      "algorithm": "md5"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to hash"
    },
    "algorithm": {
      "type": "string",
      "description": "Hash algorithm: sha256 (default), sha512, sha1, md5"
    }
  }
}
hash_text output schema
{
  "type": "object",
  "properties": {
    "hash": {},
    "algorithm": {},
    "input_length": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
hash_text annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
base64_encode
Advertised by the server during the last successful anonymous check.
Advertised read-only

Encode a UTF-8 string to Base64. Use when you need to embed binary data, multi-line text, or special characters safely inside JSON fields, HTTP headers, or data URIs.

base64_encode input schema
{
  "type": "object",
  "examples": [
    {
      "input": "héllo 🌍"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Text to encode"
    }
  }
}
base64_encode output schema
{
  "type": "object",
  "properties": {
    "encoded": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
base64_encode annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
base64_decode
Advertised by the server during the last successful anonymous check.
Advertised read-only

Decode a Base64 string back to UTF-8 text. Use for inspecting Base64-encoded API responses, JWT payload claims, config file values, or attachment data.

base64_decode input schema
{
  "type": "object",
  "examples": [
    {
      "input": "aMOpbGxvIPCfjI0="
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Base64 string to decode"
    }
  }
}
base64_decode output schema
{
  "type": "object",
  "properties": {
    "decoded": {}
  },
  "additionalProperties": true
}
base64_decode annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
url_encode
Advertised by the server during the last successful anonymous check.
Advertised read-only

Percent-encode a string for safe use in URLs. Call this before programmatically building query strings, path segments, or form-encoded bodies to prevent injection and malformed URLs.

url_encode input schema
{
  "type": "object",
  "examples": [
    {
      "input": "a b&c=d/é"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "mode": {
      "type": "string",
      "description": "\"component\" (default) or \"full\" for encodeURI behavior"
    },
    "input": {
      "type": "string",
      "description": "String to URL-encode"
    }
  }
}
url_encode output schema
{
  "type": "object",
  "properties": {
    "encoded": {}
  },
  "additionalProperties": true
}
url_encode annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
url_decode
Advertised by the server during the last successful anonymous check.
Advertised read-only

Decode a percent-encoded URL string back to plain text. Use when parsing query parameters from raw URLs or when displaying encoded values to users.

url_decode input schema
{
  "type": "object",
  "examples": [
    {
      "input": "a%20b%26c"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "URL-encoded string to decode"
    }
  }
}
url_decode output schema
{
  "type": "object",
  "properties": {
    "decoded": {}
  },
  "additionalProperties": true
}
url_decode annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_password
Advertised by the server during the last successful anonymous check.
Advertised read-only

Generate a cryptographically secure random password using crypto.randomBytes. Configurable length (4–128), uppercase letters, digits, and symbols. Use when resetting user passwords, seeding test accounts, or generating API secrets.

generate_password input schema
{
  "type": "object",
  "examples": [
    {
      "length": 24,
      "numbers": true,
      "symbols": true,
      "uppercase": true
    }
  ],
  "properties": {
    "length": {
      "type": "number",
      "description": "Password length (4–128, default: 16)"
    },
    "numbers": {
      "type": "boolean",
      "description": "Include digits (default: true)"
    },
    "symbols": {
      "type": "boolean",
      "description": "Include symbols like !@#$ (default: false)"
    },
    "uppercase": {
      "type": "boolean",
      "description": "Include uppercase letters (default: true)"
    }
  }
}
generate_password output schema
{
  "type": "object",
  "properties": {
    "length": {
      "type": "number"
    },
    "password": {},
    "charset_size": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
generate_password annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
color_convert
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert a color between HEX, RGB, and HSL formats. Use when translating design tokens between CSS notations, verifying color accessibility, or normalizing color values from user input. Accepts #rrggbb, #rgb, rgb(r,g,b), or hsl(h,s%,l%).

color_convert input schema
{
  "type": "object",
  "examples": [
    {
      "input": "rgb(18, 52, 86)"
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Color value to convert, e.g. \"#ff6b6b\", \"rgb(255,107,107)\", \"hsl(0,100%,71%)\""
    }
  }
}
color_convert output schema
{
  "type": "object",
  "properties": {
    "b": {},
    "g": {},
    "r": {},
    "hex": {},
    "hsl": {
      "type": "string"
    },
    "rgb": {
      "type": "string"
    },
    "input": {}
  },
  "additionalProperties": true
}
color_convert annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
number_base_convert
Advertised by the server during the last successful anonymous check.
Advertised read-only

Convert numbers between bases: decimal, binary, octal, hexadecimal, or any base 2–36. Auto-detects 0x, 0b, 0o prefixes.

number_base_convert input schema
{
  "type": "object",
  "examples": [
    {
      "input": "ff",
      "to_base": 10,
      "from_base": 16
    }
  ],
  "required": [
    "input"
  ],
  "properties": {
    "input": {
      "type": "string",
      "description": "Number to convert (e.g., \"255\", \"0xFF\", \"0b1010\", \"0o77\")"
    },
    "to_base": {
      "type": "number",
      "description": "Target base 2–36 (omit to get all common bases)"
    },
    "from_base": {
      "type": "number",
      "description": "Source base 2–36 (auto-detects prefix if omitted)"
    }
  }
}
number_base_convert output schema
{
  "type": "object",
  "properties": {
    "octal": {
      "type": "string"
    },
    "binary": {
      "type": "string"
    },
    "result": {
      "type": "string"
    },
    "decimal": {},
    "to_base": {},
    "from_base": {},
    "hexadecimal": {
      "type": "string"
    }
  },
  "additionalProperties": true
}
number_base_convert annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
generate_hmac
Advertised by the server during the last successful anonymous check.
Advertised read-only

Compute an HMAC signature for a message using a secret key. Supports SHA-256 (default), SHA-512, SHA-1, and MD5. Used for API request signing, webhook verification (GitHub, Stripe, Twilio), and JWT validation.

generate_hmac input schema
{
  "type": "object",
  "examples": [
    {
      "secret": "k",
      "message": "msg",
      "algorithm": "sha256"
    }
  ],
  "required": [
    "message",
    "secret"
  ],
  "properties": {
    "secret": {
      "type": "string",
      "description": "Secret key"
    },
    "message": {
      "type": "string",
      "description": "Message to sign"
    },
    "encoding": {
      "enum": [
        "hex",
        "base64",
        "base64url"
      ],
      "type": "string",
      "description": "Output encoding (default: hex)"
    },
    "algorithm": {
      "type": "string",
      "description": "Hash algorithm: sha256 (default), sha512, sha1, md5"
    }
  }
}
generate_hmac output schema
{
  "type": "object",
  "properties": {
    "hmac": {},
    "encoding": {},
    "algorithm": {},
    "message_length": {
      "type": "number"
    }
  },
  "additionalProperties": true
}
generate_hmac annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

Too few checks for a percentage yet (5 of 5 answered).

  1. 2026-11-07: 1 of 1 checks answered
  2. 2026-11-09: 2 of 2 checks answered
  3. 2026-11-10: 2 of 2 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
1106 ms
95th percentile latency
1106 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 1106 ms · metadata changed · 152 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http ia-qa-mcp https://www.ia-qa.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add ia-qa-mcp --url https://www.ia-qa.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable ia-qa-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "ia-qa-mcp": {
      "url": "https://www.ia-qa.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "ia-qa-mcp": {
      "type": "streamableHttp",
      "url": "https://www.ia-qa.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start ia-qa-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "ia-qa-mcp": {
      "type": "http",
      "url": "https://www.ia-qa.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http ia-qa-mcp https://www.ia-qa.com/mcp

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://www.ia-qa.com/mcp

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "ia-qa-mcp": {
      "serverUrl": "https://www.ia-qa.com/mcp"
    }
  }
}

Let your agent find its tools

Find servers like IA-QA MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.