Agent Enhancer Utilities

MCP Schema Edge-Case Atlas

Provides versioned schema fragments with valid and invalid examples for six narrow interoperability edges. These are portable test vectors, not claims about an untested host or SDK.

Use when

  • A developer needs a portable JSON Schema edge-case test vector for an MCP tool.
  • Valid and invalid examples are needed without claiming host behavior.

Do not use when

  • Empirical compatibility results for a named host or SDK are required.
  • The requested edge case is outside the six published vectors.

Invocation contract

HTTP
/v1/tools/mcp-schema-edge-case-atlas
Version
0.1.0
Mode
lookup
Idempotency
not required
Retention
The caller supplies only a case identifier. Test vectors are versioned code-backed data.
Tested with
JSON Schema 2020-12, MCP tool input schemas

Positive and negative examples

{
  "input": {
    "case_id": "closed-object"
  },
  "output": {
    "case_id": "closed-object",
    "data_version": "2026.07.25.1",
    "scope": "portable-test-vector",
    "schema": {
      "type": "object",
      "properties": {
        "key": {
          "type": "string"
        }
      },
      "required": [
        "key"
      ],
      "additionalProperties": false
    },
    "valid_examples": [
      {
        "key": "value"
      }
    ],
    "invalid_examples": [
      {
        "key": "value",
        "extra": true
      }
    ],
    "interoperability_risk": "Some generators omit additionalProperties and hosts may then accept undeclared arguments.",
    "empirical_host_claim": false
  },
  "negative": [
    {
      "scenario": "Empirical compatibility results for a named host or SDK are required.",
      "expected_error": "INVALID_INPUT",
      "charged": false
    }
  ]
}

Deterministic errors

CodeRetryChargedRecovery
INVALID_INPUTfalsefalseCorrect the request to match input_schema.
TOOL_PAUSEDtruefalseWait for the operator to resume the tool.
RATE_LIMITEDtruefalseRetry after the response Retry-After interval.
DEPENDENCY_UNAVAILABLEtruefalseRetry with the same idempotency identity.

Full machine manifest

The HTTP, OpenAPI, MCP, llms.txt, and ARD descriptions are generated from this same registry record.

Open JSON manifest →