Diogenes Developer, Data & Prompt Engineering Utilities MCP
This server provides developer and data utilities for repairing JSON, synthesizing safe regex, compiling XML prompts, enforcing JSON schema, verifying context compaction, auditing hallucinations, and cleaning tabular data.
json_repair: Heals truncated or malformed JSON strings, unescaped quotes, and trailing commas.
regex_oracle: Synthesizes linear-time O(n) ReDoS-safe regular expressions with positive/negative test validation.
agent_prompt_compiler: Compiles raw instructions into structured, hallucination-resistant XML system prompts with guardrails.
agent_schema_enforcer: Enforces strict JSON Schema compliance, automatic type coercion, and extraneous field pruning on LLM outputs.
context_compaction_verifier: Audits pre-compaction vs. post-compaction state summaries to ensure zero dropped constraints, wallet addresses, or IDs.
hallucination_auditor: Cross-references agent claims and numbers against provided source passages to compute grounded factuality scores.
clean_tabular_data: Normalizes, deduplicates, and strips injection payloads from untrusted CSV and JSON tabular datasets.
Provides an agent prompt compiler that transforms raw instructions into structured, hallucination-resistant XML system prompts with guardrails.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Diogenes Developer, Data & Prompt Engineering Utilities MCPrepair this malformed JSON: {"name": "Ada", "age": 36,}"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Diogenes Developer, Data & Workflow Orchestration MCP (diogenes-dev-utilities-mcp)
Diogenes Developer, Data & Workflow Orchestration MCP is a focused, zero-bloat Model Context Protocol (streamable-http) package powered by the Diogenes Autonomous Microservice Gateway.
Instead of loading all 85 gateway endpoints into your LLM's context window, installing this package exposes only the 14 specialized dev-utilities tools needed for Developer Tools:
14 TDQS 5.0/5.0 data extraction, schema healing & workflow orchestration tools: malformed JSON healer, JSON Schema type enforcer, unstructured entity extractor, tabular dataset cleaner, O(n) ReDoS-safe regex synthesizer, XML prompt compiler, Python script synthesizer, RFC summarizer, grounded web brief, context compaction verifier, MCP workflow router, escrow arbiter, MPP session planner, and x402 embedding generator.
1-Click Install (mcp.json) for Cursor, Claude Desktop & Windsurf
No API keys, user accounts, or local dependencies required. Add this scoped endpoint to .cursor/mcp.json or claude_desktop_config.json:
{
"mcpServers": {
"diogenes-dev-utilities": {
"transport": "streamable-http",
"url": "https://diogenes-micro-gateway.corinth.workers.dev/mcp/dev-utilities"
}
}
}Related MCP server: omniventure-agent-tools
Included Tools in dev-utilities (14 Tools)
MCP Tool Name | Underlying REST Route | Settlement | Capability |
|
| 50 sats (L402) | Repairs broken or truncated JSON strings by stripping markdown fences, removing trailing commas, balancing unclosed brackets/quotes, and converting Python literals (None/True/False) into valid RFC 8259 JSON. Use when fixing syntax-broken JSON strings that fail JSON.parse(); for coercing field types and pruning extra properties on already-parseable JSON objects against a target JSON Schema, use enforce_json_schema_types instead. Read-only edge call (32 KB, 60 RPM): accepts 'malformed_json' (with enum defaults), uses '?demo=true' or L402 (50 sats); HTTP 400 if invalid. |
|
| 75 sats (L402) | Validates a raw LLM output object against a target JSON Schema, automatically coercing mismatched scalar types (e.g. string '42' to integer 42), injecting schema defaults, and pruning undeclared hallucinated fields. Use when enforcing schema compliance and type safety on structured LLM outputs before passing them to typed APIs; for healing unparseable raw JSON text with broken quotes or trailing commas, use heal_malformed_json instead. Read-only edge call (32 KB, 60 RPM): accepts 'raw_output' (with enum defaults), uses '?demo=true' or L402 (75 sats); HTTP 400 if invalid. |
|
| 150 sats (L402) | Extracts structured JSON records, named entities, dates, and financial figures from unstructured prose, emails, or HTML/Markdown dumps. Use when converting unstructured natural-language text into a structured JSON array of entities; for validating and coercing an existing JSON payload against a formal JSON Schema, use enforce_json_schema_types instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'text' ('extraction_target' defaults to 'general_entities_and_metrics'), supports '?demo=true' or L402 (150 sats), and returns HTTP 400 if invalid. |
|
| 100 sats (L402) | Deduplicates repetitive lines or records, normalizes Unicode whitespace, strips HTML/control noise, and canonicalizes tabular text or JSON arrays. Use when cleaning noisy scraped lists, CSV rows, or duplicate log lines before indexing or analysis; for extracting typed JSON fields from free-form prose paragraphs, use extract_structured_json_entities instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'data' ('normalization_mode' defaults to 'exact_match'), supports '?demo=true' or L402 (100 sats), and returns HTTP 400 if invalid. |
|
| 50 sats (L402) | Synthesizes linear-time O(n) regular expressions free of catastrophic backtracking (ReDoS) and validates them against positive and negative test strings. Use when generating and verifying a regular expression pattern for input validation or lexical parsing; for repairing broken JSON syntax directly without writing custom regexes, use heal_malformed_json instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'description' ('flavor' defaults to 'ecmascript_js'), supports '?demo=true' or L402 (50 sats), and returns HTTP 400 if invalid. |
|
| 100 sats (L402) | Compiles a raw task description into a structured XML system prompt (, , , , , <output_format>) engineered to prevent instruction drift. Use when authoring or upgrading a system prompt for an autonomous agent or sub-agent workflow; for mapping a task objective to a concrete sequence of MCP tool calls, use route_mcp_workflow_plan instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'task' ('prompt_style' defaults to 'anthropic_xml_tags'), supports '?demo=true' or L402 (100 sats), and returns HTTP 400 if invalid. |
|
| 300 sats (L402) | Synthesizes PEP 8 compliant, self-contained Python 3 scripts, data parsers, and CLI utilities complete with type hints, docstrings, and inline assertion tests. Use when generating a standalone Python automation script or parser from a functional specification; for summarizing existing documentation or codebases into executive bullet points, use summarize_technical_document instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'prompt' ('dependency_policy' defaults to 'stdlib_only'), supports '?demo=true' or L402 (300 sats), and returns HTTP 400 if invalid. |
|
| 100 sats (L402) | Condenses long technical specifications, RFCs, research papers, or meeting transcripts into high-density executive bullet points preserving exact figures and decisions. Use when producing a human-readable executive summary of a single provided document; for researching a topic across the live web with Google Search citations, use synthesize_web_intelligence_brief instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'text' ('summary_format' defaults to 'executive_bullets'), supports '?demo=true' or L402 (100 sats), and returns HTTP 400 if invalid. |
|
| 200 sats (L402) | Synthesizes a real-time market or technical intelligence brief grounded in live Google Search, returning strict JSON ('executive_summary', 'key_developments', 'sentiment', 'sources'). Use when fetching a structured JSON market/news brief with live web citations and sentiment classification; for summarizing caller-supplied text offline without live web search, use summarize_technical_document instead. Read-only edge call (32 KB, 60 RPM): accepts 'topic' ('focus' defaults to 'technical_and_market_catalysts'), supports '?demo=true' or L402 (200 sats), and returns HTTP 400 if invalid. |
|
| 90 sats (L402) | Audits a compacted conversation summary against the original full context to detect dropped user constraints, lost file paths, altered numbers, or missing pending tasks. Use when verifying that an LLM context-compaction summary retained all task-critical facts before truncating history; for generating a new executive summary from a raw technical document, use summarize_technical_document instead. Read-only edge call (32 KB, 60 RPM): accepts 'original_context' ('compacted_summary' defaults to 'standard'), supports '?demo=true' or L402 (90 sats), and returns HTTP 400 if invalid. |
|
| 100 sats (L402) | Maps a natural-language agent goal to an ordered sequence of Diogenes MCP tool calls with exact endpoint paths, JSON-RPC 2.0 payloads, and cumulative satoshi cost estimates. Use when planning which MCP tools to chain together to solve a multi-step objective within a satoshi budget; for compiling a static XML system prompt rather than an executable MCP tool call sequence, use compile_xml_agent_prompt instead. Read-only edge call (32 KB, 60 RPM): accepts 'objective' ('budget_preference' defaults to 'lowest_sats_deterministic'), uses '?demo=true' or L402 (100 sats); HTTP 400 if invalid. |
|
| 150 sats (MPP) | Evaluates a worker agent's submitted task deliverable against agreed contract acceptance criteria to issue a deterministic escrow settlement verdict ('RELEASE_FUNDS_TO_WORKER_AGENT', 'REQUEST_REVISION', or 'REFUND_CLIENT'). Use when settling multi-agent bounties or verifying subcontractor deliverables before releasing MPP/L402 escrow funds; for checking syntactic JSON Schema property types without evaluating semantic contract terms, use enforce_json_schema_types instead. Read-only call (32 KB, 60 RPM): accepts 'deliverable' (with enum defaults), uses '?demo=true' or MPP (150 sats); HTTP 400 if invalid. |
|
| 500 sats (MPP) | Initializes a Base USDC Machine Payments Protocol (MPP) metered inference session, allocating a streaming token quota and returning a step-by-step execution plan. Use when running session-metered agent planning settled via Base EVM MPP 'Payment-Challenge' headers; for mapping a task goal to L402 MCP tool calls without opening an MPP streaming session, use route_mcp_workflow_plan instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'task' ('token_quota_tier' defaults to 'compact_1024'), supports '?demo=true' or MPP (500 sats), and returns HTTP 400 if invalid. |
|
| 100 sats (x402) | Generates normalized high-dimensional semantic vector embeddings settled via Solana SPL USDC ('x402' protocol headers) for decentralized RAG pipelines. Use when computing text embeddings paid via Solana USDC x402 signatures rather than Bitcoin Lightning; for extracting discrete JSON entities from unstructured text, use extract_structured_json_entities instead. Stateless read-only edge call (max 32 KB, 60 RPM): accepts 'text' ('encoding_format' defaults to 'float_array'), supports '?demo=true' or x402 (100 sats), and returns HTTP 400 if invalid. |
Free Account-Less Demo Mode: Append
?demo=trueto any REST endpoint above for an instant HTTP 200 schema preview at zero cost.
Other Modular Diogenes MCP Packages
Install only the domain packages relevant to your workflow:
Package | Scoped MCP Endpoint | Spoke Repository |
1. Gemini Suite & Agents |
| |
2. Agent Guardrails & Sandbox |
| |
3. Web3, DeFi & 402 Security |
| |
4. EVE: Frontier Sui Move Suite |
| |
5. Context, Code & Solvers (15 Tools) |
| |
6. Dev, Data & Workflow Utilities (14 Tools) |
| |
7. Full Master Gateway (All 85 Services) |
|
TensorBlock & MCP Index Profile Metadata
Field | Value |
Category |
|
Transport |
|
Endpoint |
|
Manifest |
|
Health Check |
|
Auth |
|
Install Confidence |
|
License |
|
Verification |
|
Maintainer |
|
Docs |
|
Support |
|
Available Tools
7 toolsagent_prompt_compilerCInspect
Compiles raw instructions into structured, hallucination-resistant XML system prompts with guardrails.
| Name | Required | Description | Default |
|---|---|---|---|
| raw_instructions | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations are provided, so the description must carry the full behavioral burden. It mentions output characteristics ('hallucination-resistant XML system prompts with guardrails') but does not disclose processing behavior, error handling, determinism, or side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single, front-loaded sentence with no wasted words. It clearly states the transformation and the output characteristics.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a simple one-parameter tool with no output schema or annotations, the description gives enough to understand the core transformation and output type. However, it omits usage guidance, input expectations, and behavioral details that would help an agent invoke it reliably.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The single parameter has 0% schema description coverage, and the description only repeats its name ('raw instructions') without adding format, length, content expectations, or examples. It does not compensate for the missing schema documentation.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Compiles') and resource ('raw instructions') with a clear output ('structured, hallucination-resistant XML system prompts with guardrails'). It is distinct from siblings like json_repair or hallucination_auditor, though it never explicitly compares itself to them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Provides no explicit guidance on when to use this tool versus alternatives, nor any when-not conditions or prerequisites. The purpose implies it transforms raw instructions into system prompts, but usage context is left to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
agent_schema_enforcerCInspect
Enforces strict JSON Schema compliance, automatic type coercion, and extraneous field pruning on LLM outputs.
| Name | Required | Description | Default |
|---|---|---|---|
| schema | No | ||
| raw_output | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It does disclose three concrete behaviors (strict compliance, automatic type coercion, extraneous field pruning), which is more than a bare name. However, it omits failure semantics (does it error or coerce?), whether pruning is lossy, and what the caller receives back.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with no filler; the core behaviors lead. It is efficiently sized, though the extreme brevity is also the source of the coverage gaps rather than a virtue in itself.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
No annotations, no output schema, 0% parameter coverage, and a nested schema object: the description leaves too much unresolved. It does not say what validation result is returned, how failures surface, or how the optional schema parameter affects behavior.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Two parameters with 0% schema description coverage and a nested schema object, yet the description explains neither. It never says what 'schema' is for, that it is optional, or what happens when it is omitted, nor does it define the expected shape of 'raw_output'.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb+resource: it enforces JSON Schema compliance, coercion, and field pruning on LLM outputs. That is clearly distinguishable work, but it never names or contrasts itself against the closest sibling (json_repair), which also handles malformed LLM JSON. Clear, but no sibling differentiation.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no when-to-use guidance, no prerequisites, and no mention of alternatives such as json_repair for repair vs. this tool for strict validation. The agent must infer the trigger condition from the name alone.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
clean_tabular_dataBInspect
Normalizes, deduplicates, and strips injection payloads from untrusted CSV and JSON tabular datasets.
| Name | Required | Description | Default |
|---|---|---|---|
| dataset | Yes | Raw CSV or JSON dataset |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It discloses the three transformations but says nothing about whether rows are dropped during deduplication, whether the original dataset is preserved, what happens on malformed input, or what the tool returns. For a data-mutating sanitizer, that is a meaningful gap.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single dense sentence with no filler, and the operations are front-loaded in the order an agent would care about them. Nothing is wasted.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
The tool is simple (one parameter, no nested objects), but there is no output schema and the description never explains what cleaned output looks like or how it is returned. An agent would know what the tool does but not what to expect back, leaving a modest gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
There is only one parameter and schema description coverage is 100%, so the schema already documents 'Raw CSV or JSON dataset'. The description's mention of 'CSV and JSON' merely echoes the schema and adds no format, encoding, or size details. Baseline 3 applies.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description names three specific operations (normalizes, deduplicates, strips injection payloads) and a concrete resource type (untrusted CSV and JSON tabular datasets). This is far more than a restatement of the name. It does not explicitly contrast itself with siblings like json_repair, but the 'tabular' scope and security-oriented operations already differentiate it reasonably well.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to use this tool versus alternatives such as json_repair or regex_oracle, nor any prerequisite conditions. The word 'untrusted' hints at a security-cleaning context, but the agent must infer that on its own.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
context_compaction_verifierBInspect
Audits pre-compaction vs. post-compaction state summaries to ensure zero dropped constraints, wallet addresses, or IDs.
| Name | Required | Description | Default |
|---|---|---|---|
| original_context | Yes | ||
| compacted_summary | Yes |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
No annotations and no output schema, so the description carries the full behavioral burden, yet it does not state whether the tool is read-only, how it compares inputs, what it returns, or whether it mutates state. It only describes the audit goal, leaving operational traits undisclosed.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One sentence, front-loaded with the verb and scope; no filler. It is appropriately sized for the amount of information it delivers.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a two-string verifier with no annotations and no output schema, the description is thin: it omits parameter guidance, output/result semantics, and any indication of how to interpret failures. An agent would need to guess how to assemble original_context vs. compacted_summary and what the tool returns.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0% and the schema itself has no parameter descriptions. The description loosely maps the two inputs to pre- vs. post-compaction summaries, but it does not explain what each string should contain, formatting expectations, or how the comparison uses them.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
Names a specific verb (Audits) and resource (pre-compaction vs. post-compaction state summaries) and states the target invariants (zero dropped constraints, wallet addresses, IDs). The sibling set contains no other compaction verifier, so the agent can distinguish it without extra help.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
No when-to-use or when-not-to-use guidance, and no alternatives are mentioned (e.g., hallucination_auditor or agent_schema_enforcer). The intended context is only implied by the tool name and purpose.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
hallucination_auditorCInspect
Cross-references agent claims and numbers against provided source passages to compute grounded factuality scores.
| Name | Required | Description | Default |
|---|---|---|---|
| draft_response | Yes | ||
| source_documents | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden, yet it discloses nothing about whether this is read-only, what happens when the optional source_documents are omitted, how scores are computed or returned, or any rate/permission constraints. 'Compute grounded factuality scores' is the only behavioral hint.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single well-formed sentence with the core action front-loaded and no wasted clauses. Efficient, though its brevity is partly the source of the other gaps.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a tool with no annotations, no output schema, and 0% schema description coverage, one sentence is not enough. It omits the return format, behavior when source_documents is absent, and any operational constraints an agent needs to call it correctly.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is 0%, so the description must compensate, and it only loosely maps 'agent claims and numbers' to draft_response and 'source passages' to source_documents. It gives no format, structure, or optionality guidance, leaving the required/optional distinction unexplained.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description uses a specific verb ('cross-references') and names both the input resources ('agent claims and numbers', 'source passages') and the output ('grounded factuality scores'). This distinguishes it clearly from all listed siblings, none of which perform factuality evaluation, though it does not explicitly name them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
There is no statement of when to invoke this tool versus alternatives, no prerequisites, and no exclusions. An agent must infer usage purely from the name and one sentence of purpose.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
json_repairAInspect
Deterministically heals truncated or malformed JSON strings, unescaped quotes, and trailing commas.
| Name | Required | Description | Default |
|---|---|---|---|
| malformed_json | Yes | Malformed JSON string |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. "Deterministically" usefully signals no external calls and repeatable output, and the enumerated malformation types define repair scope, but it says nothing about what happens on input that cannot be repaired, whether errors are thrown, or what the returned value is.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One sentence, front-loaded with the verb and resource, with every clause (truncation, unescaped quotes, trailing commas) earning its place by scoping the repair capability.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
This is a low-complexity, single-parameter tool with no output schema, so the description is nearly sufficient. However, with no output schema present, the description should still indicate what is returned or how unrecoverable input is handled, and it does neither.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100% for the single parameter, so the baseline is 3. The description adds only indirect meaning by naming the kinds of malformation the parameter will typically contain, but no format, size, or encoding details beyond the schema.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description states a specific verb ("heals") plus resource ("JSON strings") and even enumerates the exact failure classes handled: truncation, unescaped quotes, and trailing commas. No sibling in the list (regex, schema, tabular, audit tools) overlaps, so an agent can select this unambiguously.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
Usage is implied rather than stated: an agent can infer it applies when it holds malformed JSON. There is no explicit when-to-use framing, no statement about unrecoverable input, and no named alternative or precondition.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
regex_oracleBInspect
Synthesizes linear-time O(n) ReDoS-safe regular expressions with positive/negative test validation.
| Name | Required | Description | Default |
|---|---|---|---|
| description | Yes | Pattern requirements |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations, the description carries the full behavioral burden. It does disclose meaningful traits: a complexity guarantee (linear-time O(n)), a safety property (ReDoS-safe), and a validation methodology (positive/negative tests). However, it says nothing about what is actually returned, whether generation is deterministic, what happens on an unsatisfiable or ambiguous pattern, or any side effects.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
One dense sentence with no filler; the differentiating properties (linear-time, ReDoS-safe, test validation) are front-loaded. Every clause earns its place.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a single-parameter, no-output-schema tool, the description covers the generation behavior but leaves the agent guessing about the return shape — does it return just the regex, or regex plus test cases, or a report? With no output schema and no annotations, that omission is the main remaining gap.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is 100%, so the single 'description' parameter ('Pattern requirements') is already documented by the schema and the baseline is 3. The tool description adds no extra syntax, format, or example for how to phrase requirements, so it neither compensates nor regresses.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb ('Synthesizes') and a precisely characterized resource ('linear-time O(n) ReDoS-safe regular expressions'), plus a secondary deliverable (positive/negative test validation). This is far more informative than a generic 'regex tool' label and is unmistakably distinct from the JSON/prompt/auditing siblings, though it never explicitly contrasts itself with any of them.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description says what the tool does but never says when to reach for it over alternatives, nor any prerequisites, exclusions, or constraints on the input pattern. 'ReDoS-safe' hints at a use case (safety-critical patterns) but the agent must infer that; no explicit when/when-not guidance is given.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
7 tool updates
v0.1.0- First observed
agent_prompt_compiler - First observed
agent_schema_enforcer - First observed
clean_tabular_data - First observed
context_compaction_verifier - First observed
hallucination_auditor - First observed
json_repair - First observed
regex_oracle
TDQS
Scored across 7 tools
Each tool has a largely distinct purpose: JSON repair, regex generation, prompt compilation, schema enforcement, context verification, hallucination auditing, and tabular cleaning. Minor overlap exists between json_repair and agent_schema_enforcer for JSON handling, and between context_compaction_verifier and hallucination_auditor for verification, but descriptions clarify the different targets.
All names use snake_case, which is consistent, but the structural pattern varies: json_repair and clean_tabular_data are verb-based, while regex_oracle, agent_prompt_compiler, agent_schema_enforcer, context_compaction_verifier, and hallucination_auditor are noun phrases ending in agent/tool roles. Readable but not a single predictable convention.
Seven tools is well within the ideal 3-15 range and appropriate for a utility server. Each tool addresses a distinct developer, data, or prompt engineering need without redundancy.
The surface covers key prompt and data engineering tasks: JSON repair, safe regex, prompt compilation, schema enforcement, compaction verification, hallucination auditing, and tabular cleaning. Minor gaps exist, such as handling YAML/XML or token counting, but the core utility set is broad and self-contained.
Maintenance
Related MCP Connectors
Deterministic JSON repair, validate, example-gen, schema-coerce for agents. Zero LLM, sub-10ms.
Repair malformed JSON from LLM/agent output; optional JSON Schema coercion. Free + x402 paid.
Repair broken LLM JSON and check it against a JSON Schema. Flags cut-off output. Free trial.
- SnipgetOAuthai.snipget
300+ deterministic data utilities for AI agents: validate, normalize, parse, match, redact.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceDeterministic JSON validation and repair for AI agents. Validates, repairs, schema-checks, and diffs JSON so long-running agents don't corrupt their session state with malformed writes.MIT
- AlicenseAqualityCmaintenanceSub-15ms edge intelligence tools for Claude Desktop, Cursor, and LLM agent loops. Provides sub-millisecond LLM JSON repair, web-to-markdown token compression (cuts context tokens up to 90%), PII redaction, and RFC 5322 B2B email deliverability verification at zero marginal token cost.6MIT
- AlicenseNot gradedqualityBmaintenanceEnables agents to diagnose JSON incompatibilities against target schemas and explicit rules, then receive bounded deterministic repairs independently verified before delivery.MIT
- AlicenseNot gradedqualityAmaintenanceProvides deterministic JSON repair and JSON Schema validation for malformed AI agent outputs, safely fixing unambiguous errors without an LLM and refusing ambiguous cases.84 PyPIMIT