{"_id":"@adaptivmapr/mcp-server","name":"@adaptivmapr/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@adaptivmapr/mcp-server","version":"0.1.0","description":"MCP server for AdaptivMapr — healthcare-aware schema mapping over Model Context Protocol.","license":"MIT","type":"module","bin":{"adaptivmapr-mcp-server":"dist/index.js"},"main":"dist/index.js","scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.0.0","papaparse":"^5.4.1","zod":"^3.23.0"},"devDependencies":{"@types/node":"^22.0.0","@types/papaparse":"^5.3.15","tsx":"^4.19.0","typescript":"^5.6.0"},"engines":{"node":">=18"},"repository":{"type":"git","url":"git+https://github.com/adaptivmapr/mcp-server.git"},"homepage":"https://adaptivmapr.com","bugs":{"url":"https://github.com/adaptivmapr/mcp-server/issues"},"keywords":["mcp","model-context-protocol","data-import","csv","schema-mapping","ai","adaptivmapr"],"publishConfig":{"access":"public"},"types":"./dist/index.d.ts","_id":"@adaptivmapr/mcp-server@0.1.0","_nodeVersion":"22.22.1","_npmVersion":"9.2.0","dist":{"integrity":"sha512-4sgUUKTr3s2NCPit3Ie9v3Jl/SmK0v5yM83bSvfqeOM5FzmLq+HF/fbJ69e+r0VcvxqZ+m8HPxM//gsj1l1vFQ==","shasum":"c6839dd662ed86df083bf3c12c1fd1edc8f0a88c","tarball":"https://registry.npmjs.org/@adaptivmapr/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":11,"unpackedSize":22850,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEYTUrZvPAn3cOky6yFgekaGHJwvBwc5U8EHzuv8yygZAiEAtGSWwFpPVFkQnEIw/snrRil6Uj5NVY3+0vIY3harlyU="}]},"_npmUser":{"name":"wabh","email":"interimed.company@gmail.com"},"directories":{},"maintainers":[{"name":"wabh","email":"interimed.company@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1780504273506_0.6800123174170474"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-03T16:31:13.278Z","0.1.0":"2026-06-03T16:31:13.646Z","modified":"2026-06-03T16:31:13.861Z"},"maintainers":[{"name":"wabh","email":"interimed.company@gmail.com"}],"description":"MCP server for AdaptivMapr — healthcare-aware schema mapping over Model Context Protocol.","homepage":"https://adaptivmapr.com","keywords":["mcp","model-context-protocol","data-import","csv","schema-mapping","ai","adaptivmapr"],"repository":{"type":"git","url":"git+https://github.com/adaptivmapr/mcp-server.git"},"bugs":{"url":"https://github.com/adaptivmapr/mcp-server/issues"},"license":"MIT","readme":"# @adaptivmapr/mcp-server\n\nMCP server for [AdaptivMapr](https://adaptivmapr.com) — data adaptation\nover Model Context Protocol.\n\nThis package exposes AdaptivMapr's mapping primitives as MCP tools so a\ndeveloper in Cursor, Claude Desktop, or any MCP-aware client can drive a\ndata import end-to-end without touching the REST API directly.\n\n- **Free, schema-only tools** work with no API key — only column headers\n  and up to 3 sample rows ever leave the caller.\n- **Gated, full-data tools** require an AdaptivMapr API key. Full-data\n  LLM cleanup is metered against your plan.\n\n## Install\n\nOne-shot, no config:\n\n```bash\nnpx -y @adaptivmapr/mcp-server\n```\n\n## Claude Desktop / Cursor config\n\nAdd to `claude_desktop_config.json` (Claude Desktop) or your MCP config\n(Cursor):\n\n```json\n{\n  \"mcpServers\": {\n    \"adaptivmapr\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@adaptivmapr/mcp-server\"],\n      \"env\": {\n        \"ADAPTIVMAPR_API_KEY\": \"am_live_...\",\n        \"PHI_GATEWAY_API_KEY\": \"phi_live_...\"\n      }\n    }\n  }\n}\n```\n\nBoth env vars are optional. Without them the server still registers the\nfree tools and rejects the gated ones with an upgrade message.\n\n### Environment variables\n\n| Variable | Default | Purpose |\n|---|---|---|\n| `ADAPTIVMAPR_API_URL` | `https://api.adaptivmapr.com` | Override the AdaptivMapr control-plane base URL. |\n| `ADAPTIVMAPR_API_KEY` | _(unset)_ | Required for any gated tool. |\n| `PHI_GATEWAY_API_KEY` | _(unset)_ | Required for healthcare full-data calls routed through PHI Gateway. |\n| `PHI_GATEWAY_URL` | `https://api.phi-gateway.dev` | Override the PHI Gateway base URL. |\n| `ADAPTIVMAPR_SELFHOSTED_WORKER_URL` | _(unset)_ | Required for `adaptivmapr.commit_to_database`. |\n| `ADAPTIVMAPR_MCP_TELEMETRY` | _(on)_ | Set to `0` to disable anonymous telemetry. |\n| `ADAPTIVMAPR_TELEMETRY_URL` | `https://telemetry.adaptivmapr.com/mcp` | Override the telemetry endpoint. |\n\n## Tool catalogue\n\n### Free (schema-only — no API key required)\n\n| Tool | What it does |\n|---|---|\n| `adaptivmapr.list_templates` | List the pre-built templates (pack, FHIR resource where applicable, risk, languages). |\n| `adaptivmapr.template_schema` | Return the full schema (columns, validators, hints) for one template. |\n| `adaptivmapr.match_headers` | Match headers + up to 3 sample rows against a template. Hard-capped to 3 rows. |\n| `adaptivmapr.validate_row` | Validate one row against a template's per-field validators. |\n| `adaptivmapr.csv_preview` | Pure-local Papaparse helper. Returns headers + first N rows of a CSV. 50 MB max. |\n\n### Gated (full-data — requires `ADAPTIVMAPR_API_KEY`)\n\n| Tool | What it does |\n|---|---|\n| `adaptivmapr.match_full_file` | Full-file mapping with LLM cleanup on the long tail. |\n| `adaptivmapr.commit_to_webhook` | Commit validated rows from an upload to a customer webhook. |\n| `adaptivmapr.commit_to_database` | Commit validated rows via a self-hosted worker. Also requires `ADAPTIVMAPR_SELFHOSTED_WORKER_URL`. |\n\n## Telemetry\n\nOpt-in anonymous install and per-tool invocation counts. The payload\ncontains:\n\n- An anonymous install ID (a UUIDv4 cached at `~/.config/adaptivmapr/mcp-install-id`).\n- The event name (`install` or `invoke`).\n- For `invoke`, the tool name (e.g. `adaptivmapr.match_headers`).\n- The package version and a timestamp.\n\nWhat is **never** sent:\n\n- Tool arguments\n- Response bodies\n- Request headers\n- File paths\n- Row values\n- Header values\n\nThe telemetry endpoint is separate from the mapping API, so a network\nblock on telemetry never degrades tool function. Disable entirely with:\n\n```bash\nADAPTIVMAPR_MCP_TELEMETRY=0\n```\n\n## License\n\nMIT. See [LICENSE](./LICENSE).\n\n## Links\n\n- Documentation: <https://adaptivmapr.com/docs>\n- AdaptivMapr: <https://adaptivmapr.com>\n- Contact: <hello@adaptivmapr.com>\n","readmeFilename":"README.md","_rev":"1-24d791ac6d3124b3eb93187d869d9bc9"}