Schema Mapper agent setup

Product, pricing and limits · Discovery index

Use Schema Mapper with your agent

Review vendor CSV field correspondences and validate a reusable mapping.

Local CLI/SDK and stdio MCP are free. Hosted preview/validation are free; $9 once per approved downloadable artifact, with no subscription.

Read the product skill · AGENT_SETUP.md · TOOL_REFERENCE.md · codex.toml · claude.mcp.json · TOOLS.json

Setup and first task

Schema Mapper agent setup

Reviewed documentation: 2026-11-01. Examples contain placeholders, never live credentials.

Install and authenticate

Use Python 3.12+ in a dedicated environment. Inspector uses its reviewed source checkout on macOS (the immutable 0.3.0 wheel is Linux-qualified); Schema Mapper can install the matching free 2.0.0b2 wheel. Install mcp>=2.3,<3 into that environment. Enable the chosen server in the client and review client tool-permission prompts; Schema tools retain their existing permission metadata. Replace every absolute-path placeholder deliberately; never execute source or requirements from the target repository. No hosted key is needed for local MCP. Launch from a trusted workspace; a working directory is not a filesystem sandbox. Trusted product repository: https://github.com/founder-sweep/contentsweep-schema-mapper. From that reviewed source checkout, choose your installed Python 3.12+ executable explicitly to create .venv (the Mac system Python may be older), then .venv/bin/python -m pip install '.[mcp]'. Set the example's command to that environment's absolute Python path. Owned examples and installation source: https://github.com/founder-sweep/contentsweep-schema-mapper.

Copy this reviewed skill bundle into .agents/skills/review-schema-mapping/ for Codex or .claude/skills/review-schema-mapping/ for Claude Code in the intended project. Copy the supporting AGENT_SETUP.md, TOOL_REFERENCE.md, TOOLS.json and client examples with it. Codex user-wide skills can instead live in ~/.agents/skills; Claude Code user-wide skills in ~/.claude/skills. Merge the Codex entry into the chosen isolated profile config.toml or reviewed ~/.codex/config.toml; merge Claude entries into project .mcp.json. Never overwrite unrelated settings. Review existing settings before merging a server entry; do not replace an entire configuration file. Restart or create a fresh client session and confirm tool discovery.

Codex configuration

[mcp_servers."review-schema-mapping"]
command = "/ABSOLUTE/TO/REVIEWED/ENV/bin/python"
args = ["-m", "mcp_products.schema_mapper.mcp"]
cwd = "/ABSOLUTE/TO/TRUSTED/WORKSPACE"

Claude Code configuration

{
  "mcpServers": {
    "review-schema-mapping": {
      "type": "stdio",
      "command": "/ABSOLUTE/TO/REVIEWED/ENV/bin/python",
      "args": [
        "-m",
        "mcp_products.schema_mapper.mcp"
      ]
    }
  }
}

Synthetic first task

Use the owned vendor/customer-schema example. Review every correspondence before approving the fixture and compare interpreted output with the generated wrapper. Fixture approval never authorizes a real customer's mapping.

Workflow

Use an explicitly authorized local source path and a trusted installed runtime. Infer the source schema, propose correspondences, review evidence and alternatives, and ask the user to resolve business meanings, null policy and casts. Record authorized approval binding the exact fingerprint and user/vendor/domain scope. Validate before transformation or generation. Preserve string identifiers and exact decimals using the product serialization helpers. Use absolute source paths when the client working directory is uncertain.

Recovery and credit effects

Reject unresolved choices, fingerprint/scope mismatches, unsupported contracts and structural drift. Re-review before approving a new mapping. Scores are ranking signals, not probabilities. Do not execute supplied code. The generated wrapper depends on the matching runtime. Hosted purchase is an optional convenience and requires separate authorization; no local MCP call purchases an artifact.

Price and bounds

Local CLI/SDK and stdio MCP are free. Hosted preview/validation are free; $9 once per approved downloadable artifact, with no subscription.

Flat CSV/JSON/JSONL and the documented primitive schema/cast subset. Hosted uploads are limited to 1 MiB. Python 3.12+ and the matching free runtime are required for generated wrappers.

Official client references: https://learn.chatgpt.com/docs/extend/mcp?surface=cli and https://code.claude.com/docs/en/mcp. Skill installation references: https://learn.chatgpt.com/docs/build-skills and https://code.claude.com/docs/en/skills.

Configuration, actual MCP execution and paid customer adoption are different outcomes. Qualification fixtures and internal accounts are not customers.

Optional account and funding workflow

Open https://schema.contentsweep.ai/?campaign=agent-skill in the operator's browser. Try the free synthetic example or upload an authorized flat file and explicit target JSON Schema. Review each correspondence and validate every actual record. Failed validation cannot enter Checkout. Show the operator the approved artifact and $9 price before purchasing.

The operator completes the existing Checkout. Maintain the same private browser session on return; its cookie and CSRF protect order ownership. The API is documented at https://schema.contentsweep.ai/openapi.json but is not an API-key service. Do not bypass session/Origin/CSRF protections, open the order in an unrelated session, or buy automatically.

After confirmed settlement, download the ZIP immediately in the owning session. It contains mapping.approved.json, transform.py, validation-receipt.json and README.txt, not transformed source records. Downloads last up to seven days; a refund revokes future downloads. Saved artifacts and runtime reuse are free. Verify receipt fingerprints against the approved mapping and validate local transformed records; do not execute untrusted user-supplied Python as validation.

A second vendor or changed structural mapping requires a new review. A new hosted artifact has its own $9 purchase; never describe this as funding a reusable wallet. On a lost session, use the product support flow; do not attempt another identity to recover private artifacts.

Guides: https://schema.contentsweep.ai/guides. Free sample: https://schema.contentsweep.ai/sample. Privacy: https://schema.contentsweep.ai/privacy.

Current tool reference

Task-to-tool reference

Generated from the unchanged product MCP declarations. Parameter types and source hash are in TOOLS.json.

infer_schema

Infer flat schema from a bounded local CSV/JSON/JSONL file.

- Task: Inspect the supplied original file - Prerequisites: Explicit permission to read the source; remote upload also needs permission to transmit it - Outputs: Upload identity/fingerprint or bounded inferred schema - Approval: Source-file access/upload authorization - Credits: No credits consumed - Retry: Uploads create new identities; reuse the successful upload rather than uploading again

map_to_schema

Propose correspondence; strict JSON strings preserve decimal precision.

- Task: Prepare decisions for review - Prerequisites: Owned source plus explicit target rules/decisions - Outputs: Unapproved proposal, version or sampled preview; not approval or full validation - Approval: Do not infer business meanings; obtain missing decisions - Credits: No credits consumed - Retry: Reads/previews may repeat; saved drafts/versions can create new identities

review_mapping

Inspect exact proposal, evidence, alternatives and approval state.

- Task: Review validity, drift or correspondences - Prerequisites: Exact proposed/approved mapping, explicit target/source and matching scope where required - Outputs: Validation/review/drift report; stop on unsupported or mismatched inputs - Approval: Read access within the user's task - Credits: No credits consumed - Retry: Safe to repeat unchanged validation; changed decisions need review

resolve_mapping

Explicit target:source decisions; null skips an optional target.

approve_mapping

Record user-authorized review of an exact mapping for a named scope.

- Task: Record exact reviewed approval - Prerequisites: Exact reviewed hash/fingerprint and scope, with all unresolved choices settled - Outputs: Approval bound to that exact version - Approval: Explicit authorized reviewer approval; fixture permission covers only owned fixtures - Credits: No credits consumed - Retry: Reuse only the same reviewed version and scope; edits invalidate approval

validate_schema_mapping

Check schema, completeness, exact fingerprints, decisions and approval.

check_schema_drift

Compare a local input schema against approved scope and schema version.

transform_file

Transform an approved local snapshot; return exact JSON and receipt.

- Task: Create a reusable local output - Prerequisites: Reviewed approved mapping with matching fingerprint/scope; validate first - Outputs: Exact transformed records and receipt, or matching-runtime Python wrapper text; MCP does not save an output file - Approval: Explicit mapping approval and read access; saving output or executing a generated wrapper requires its own authorization - Credits: No credits consumed - Retry: Repeat only for the same approved mapping and scope; the caller must deliberately save returned data if requested

generate_transformation

Emit approved runtime-dependent Python; never executes supplied code.