# JSON Canon

> JSON Canon is a paid MCP server for files and documents. Pay-per-call MCP server for JSON validation, CSV, PDF and Mexican ID checks. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Paid
- **Platforms:** API, Web
- **Website:** https://json-canon-x402.fly.dev
- **MCP Registry name:** dev.fly.json-canon-x402/json-canon
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-19

## About

The server bundles small deterministic utilities that agents can call without an account or API key. Each call is settled in USDC on Base through the x402 protocol, so requests that return a 402 challenge cost nothing until paid, and failed 4xx calls are not charged.

The toolset covers JSON Schema validation with RFC 8785 canonicalization and SHA-256 hashing, CSV to JSON conversion with per-column type inference, RFC 6902 JSON diff and patch, and PDF text and table extraction for files given by public URL or base64. It also validates Mexican RFC, CURP and CLABE identifiers offline, without querying SAT, RENAPO or the banking system.

It is aimed at developers and agent builders who need predictable data-handling steps inside a workflow, especially those working with Mexican tax or banking identifiers. Prices run from 0.01 to 0.04 USDC per call, and the server is reachable over streamable HTTP at its /mcp endpoint.

## Features

- **Pay-per-call x402 billing:** Each tool call is paid in USDC on Base, with no signup, subscription or API key required.
- **JSON validation and canonicalization:** Validates instances against an optional JSON Schema and returns RFC 8785 canonical output with SHA-256.
- **CSV to JSON with type inference:** Converts CSV rows to JSON, detects delimiters and keeps leading-zero codes as strings.
- **JSON diff and patch:** Generates RFC 6902 patches between two documents and applies patches to a document.
- **PDF text and table extraction:** Pulls per-page text and tables from PDFs up to 4 MiB, flagging likely scanned files since there is no OCR.
- **Offline Mexican ID validation:** Checks RFC, CURP and CLABE format, embedded dates and check digits without calling external registries.

## Good for

- Validate and canonicalize JSON payloads before hashing or storing them in an agent workflow
- Convert CSV exports into JSON rows with inferred types for downstream processing
- Generate and apply JSON Patch documents when an agent edits structured records
- Extract text or tables from invoices and other PDFs given by public URL
- Check Mexican RFC, CURP or CLABE values for format and check digits before form submission

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http json-canon https://json-canon-x402.fly.dev/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://json-canon-x402.fly.dev/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "json-canon": {
      "url": "https://json-canon-x402.fly.dev/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "json-canon": {
      "type": "http",
      "url": "https://json-canon-x402.fly.dev/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "json-canon": {
      "serverUrl": "https://json-canon-x402.fly.dev/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://json-canon-x402.fly.dev/mcp
```

Enter a Name (for example "JSON Canon"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "json-canon": {
      "type": "http",
      "url": "https://json-canon-x402.fly.dev/mcp"
    }
  }
}
```

## Tools

All 10 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `validate_json` (says read-only): Validate a JSON instance against an optional JSON Schema and return RFC 8785 canonical JSON plus SHA-256. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/validate.
- `csv_to_json` (says read-only): Convert CSV to JSON rows with per-column type inference (integer, number, boolean, null, string), delimiter auto-detection and a generated JSON Schema. Leading-zero codes (ZIP, CLABE) stay strings. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/csv-to-js
- `json_diff` (says read-only): Compare two JSON documents and return the RFC 6902 JSON Patch that turns source into target, plus canonical SHA-256 of each side. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/json-diff.
- `json_patch` (says read-only): Apply an RFC 6902 JSON Patch to a JSON document and return the result and its canonical SHA-256. Failed 'test' ops return 409 and are not charged. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/json-patch.
- `pdf_text` (says read-only): Extract text per page from a PDF given by public URL or base64 (max 4 MiB, 100 pages). No OCR: scanned PDFs are flagged as likely_scanned. Price: 0.02 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/pdf-text.
- `pdf_tables` (says read-only): Extract tables (rows and header-keyed records) from a PDF given by public URL or base64 (max 4 MiB, 30 pages). 'lines' strategy for ruled tables, 'text' for whitespace-aligned ones. Price: 0.04 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/pdf-tables.
- `mx_rfc` (says read-only): Validate a Mexican RFC tax ID (persona física or moral): format, embedded date, homoclave and SAT check digit. Offline; does not query SAT. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/mx/rfc.
- `mx_curp` (says read-only): Validate a Mexican CURP: format, birth date, sex, state code, internal consonants and RENAPO check digit. Offline; does not query RENAPO. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/mx/curp.
- `mx_clabe` (says read-only): Validate an 18-digit Mexican CLABE bank account: SPEI bank code (with bank name), plaza, account and check digit. Offline; does not confirm the account exists. Price: 0.01 USDC per successful call on Base via x402 (pass the signed payment in _meta['x402/payment']; failed calls are not charged). HTTP equivalent: POST https://json-canon-x402.fly.dev/v1/mx/clabe.
- `get_pricing` (says read-only): Free. Lists every paid tool with its price, HTTP endpoint and an example input, and explains how to pay with x402.

## FAQ

### How is the server paid for?

Calls are paid per request in USDC on Base via x402, using the PayAI facilitator. Unpaid requests return HTTP 402 with a payment challenge, and failed 4xx calls are not charged.

### Does the Mexican ID validation check official registries?

No. The RFC, CURP and CLABE tools run offline and do not query SAT, RENAPO or the banking system, so they cannot confirm that an account or person exists.

### Can PDF tools read scanned documents?

Not with OCR. Scanned PDFs are flagged as likely_scanned in the response rather than having their text recovered.

### Which tools are free?

The get_pricing tool and the free HTTP endpoints such as /health, /v1/example and /openapi.json are not charged.

### Is JSON Canon free?

No. JSON Canon is a paid product.

### How do I add JSON Canon to Claude Code?

Run this command in your terminal: claude mcp add --transport http json-canon https://json-canon-x402.fly.dev/mcp

### What are the best alternatives to JSON Canon?

The closest alternatives to JSON Canon are Agent Evidence Utility, Agent Data Tools: Full list (every tool as its own definition), GeekVault, x402 Tool Shop and Agent Data Tools: Utilities.

## Where this comes from

- Description: written from the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Agent Evidence Utility](https://ai-powered.com/mcp/agent-evidence-utility): Agent Evidence Utility is a paid MCP server for files and documents.
- [Agent Data Tools: Full list (every tool as its own definition)](https://ai-powered.com/mcp/agent-data-tools-full-list-every-tool-as-its-own-definition): Agent Data Tools: Full list (every tool as its own definition) is a freemium MCP server for developer tools.
- [GeekVault](https://ai-powered.com/mcp/geekvault): GeekVault is a paid MCP server for developer tools.
- [x402 Tool Shop](https://ai-powered.com/mcp/x402-tool-shop): x402 Tool Shop is a paid MCP server for developer tools.
- [Agent Data Tools: Utilities](https://ai-powered.com/mcp/agent-data-tools-utilities): Agent Data Tools: Utilities is a freemium MCP server for developer tools.
- [Finekot API](https://ai-powered.com/mcp/finekot-api): Finekot API is a paid MCP server for files and documents.
- [Agent Tools](https://ai-powered.com/mcp/agent-tools-3): Agent Tools is a paid MCP server for files and documents.
- [xytara MCP Executor](https://ai-powered.com/mcp/xytara-mcp-executor): xytara MCP Executor is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/json-canon
