Skip to main content
Glama

Schema Mapper

Fully capable of reviewed flat-file vendor mapping, exact-value transformation and compatible reuse with the matching runtime.

Proven reviewed vendor mapping with exact identifiers and decimals, reusable transforms and drift stops. Includes a repeatable local MCP demo.

The local MCP demo stops unresolved approval, preserves identifier 000401 and decimal 123456789012.123456789, generates a reusable transform, accepts compatible input, and stops structural drift.

Inspect the result and repeat the demo · Runnable package · Capability and verification details

Current status — November 1, 2026

Current free runtime download: 2.0.0b2, Python 3.12+. Local CLI/SDK/stdio MCP need no hosted key. Optional hosted preview and validation are free; one approved artifact download is $9 once. Generated wrappers require the matching runtime. No subscription, PyPI or MCP Registry listing is claimed.

Agent setup · Product skill · Task-to-tool reference. Skills support Codex and Claude Code and grant no upload, business-meaning approval, spending or destination-write permission. Historical test notes below retain their original scope; synthetic/internal qualification is not paid adoption.

Turn a vendor CSV into a reviewed mapping and reusable Python transform.

Try the free hosted example · See the sample artifact · Working guides

The Apache-2.0 local CLI, Python SDK and stdio MCP server are free. The optional hosted workflow offers free preview and full-record validation, then a one-time $9 approved artifact download. Saved-artifact reuse is free. The hosted source limit is 1 MiB. No subscription and no model calls.

Related MCP server: Structured Data Validator & Transformer MCP Server

What it does

Infer a bounded flat CSV/JSON/JSONL schema, propose correspondences to an explicit target contract, show evidence and ambiguity, require a named review, validate all actual records, and generate a versioned mapping plus Python runtime wrapper. Leading-zero identifiers remain text. Decimal values remain exact. Structural or format changes require review.

Names and types do not establish business meaning. Review every correspondence and cast with the vendor. Scores rank candidates; they are not probabilities.

Install

Python 3.12+ is required. From this source checkout:

python -m venv .venv
.venv/bin/python -m pip install .
.venv/bin/python -m mcp_products.schema_mapper --help

Alternatively download the matching wheel from https://schema.contentsweep.ai/runtime/download and install the saved file with python -m pip install PATH_TO_WHEEL. No PyPI publication is claimed.

Review and transform a synthetic example

schema-map map examples/schema-mapper/vendor.csv --target examples/schema-mapper/customer.schema.json --out proposal.json
schema-map review proposal.json
schema-map resolve proposal.json --decisions examples/schema-mapper/decisions.json --out resolved.json
schema-map review resolved.json

For this synthetic example, the reviewed choices are account_code → customer_id, givenName → first_name, enabled → active. Copy mapping_fingerprint from the resolved review and substitute it below:

schema-map approve resolved.json --expect REVIEWED_FINGERPRINT --reviewer "Your reviewer name" --user local-user --vendor demo-vendor --domain customer-imports --out approved.json
schema-map transform approved.json examples/schema-mapper/vendor.csv --user local-user --vendor demo-vendor --domain customer-imports --out output.jsonl --receipt receipt.json
schema-map generate approved.json --out transform.py

The generated Python imports the matching free runtime; it is not self-contained. The hosted ZIP contains mapping.approved.json, transform.py, validation-receipt.json and README.txt. It does not contain transformed source records. The free sample's README contains a complete reproducible source recipe.

Local MCP quickstart

python -m pip install '.[mcp]'
python -m mcp_products.schema_mapper.mcp

Configure a trusted local MCP client with your absolute Python path and arguments -m mcp_products.schema_mapper.mcp. The process uses its launching user's local filesystem permissions. Its nine tools cover inference, proposals, review, resolution, approval, drift, validation and transformation. It is a stdio server; the hosted purchase site is an ordinary web application.

Supported bounds and tests

See SUPPORT.md. Core files are at most 4 MiB, with 50,000 rows, 128 primitive fields, strict UTF-8 and a documented flat JSON Schema subset. Hosted sources have a smaller 1 MiB cap. Nested values, locale/date conversions and arbitrary scripts are unsupported.

python -m pip install '.[mcp,service]' pytest
python -m pytest -q tests

The examples are synthetic. Test coverage is not customer validation, measured time savings, a security certification or a claim of commercial superiority. The hosted workflow processes uploaded sources on its server; read its privacy and retention statement.

Content Sweep LLC · https://schema.contentsweep.ai · founder@contentsweep.ai

Install the agent skill

Install this skill in the intended project, then choose the coding agents you use:

npx skills add founder-sweep/contentsweep-schema-mapper --skill review-schema-mapping

For Claude Code, add the ContentSweep marketplace and install this product:

claude plugin marketplace add founder-sweep/contentsweep-supplier-feed-examples
claude plugin install contentsweep-schema-mapper@contentsweep

The marketplace contains Supplier Feeds, Data Quality Gate, Inspector, Schema Mapper, DAG Doctor and Deployment Fixer. Each plugin loads its existing product skill and companion references. Installation grants no upload, spending, business-rule approval or destination-write permission. MCP connections and runtime dependencies are configured separately using the bundled agent setup. Review the supported scope, privacy, free/local options and current hosted pricing before use.

Gemini, Kilo, Cline and Cursor

Proven reviewed vendor mapping with exact identifiers and decimals, reusable transforms and drift stops. Includes a repeatable local MCP demo.

Follow client installation and recovery. Native configuration examples, required settings, the existing skill and supported scope are included. Catalog submission and acceptance are recorded separately.

Reproduce the product demo

Review a vendor mapping without losing identifiers or decimals.

Public walkthrough · Runnable package · Native agent evidence

Owned synthetic input, actual recorded output, expected stop cases, checksums, installation and pricing. The page reports native agent verification separately from deterministic MCP checks. Live hosted execution uses your own private credentials and explicit evaluation allowance.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Detects schema mismatches between data producers and consumers through static analysis, supporting extraction, comparison, code generation, and automated validation with watch mode for MCP tools, APIs, and service contracts.
      11
      55 npm
      MIT
    • A
      license
      A
      quality
      Not graded
      maintenance
      Provides AI agents with data validation, transformation, and normalization capabilities, including JSON schema validation, CSV processing, data normalization, text cleaning, and dataset merging.
      5
      70 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Provides deterministic tools for understanding, transforming, and verifying structured data via MCP, enabling rule inference from examples and verification of transformed records.
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Provides safe, deterministic inspection, transformation, validation, and diffing of structured data (JSON, CSV, YAML, Parquet) via schema-aware MCP tools.
      4
      Apache 2.0