{"data":{"name":"com.senzing/mcp","title":"Senzing","description":"Entity resolution — data mapping, SDK code generation, docs search, and error troubleshooting","version":"1.46.1","websiteUrl":"https://senzing.com","repositoryUrl":"https://github.com/Senzing/mcp","remotes":[{"type":"streamable-http","url":"https://mcp.senzing.com/mcp"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-14T18:07:04.562Z","updatedAt":"2026-11-14T18:07:04.562Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"com.senzing/mcp","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-14T18:07:04.562Z","title":"Senzing","description":"Entity resolution — data mapping, SDK code generation, docs search, and error troubleshooting","websiteUrl":"https://senzing.com","repositoryUrl":"https://github.com/Senzing/mcp"}],"toolIndex":{"tools":[{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"analyze_record","title":null,"description":"Get the Senzing JSON analyzer script to validate mapped data files client-side. REQUIRED: `workspace_dir` (writable directory, e.g. ~/sz-workspace) — the call WILL FAIL without it.\n\nThe analyzer validates records against the Entity Specification, examines feature distribution, attribute coverage, and data quality. Returns a Python script (no dependencies) with instructions. No source data is sent to the server.\n\nTypical workspace_dir values: Linux `/tmp` or `~/sz-workspace`; macOS `~/sz-workspace`; sandboxed envs: explicit path under home (do NOT assume /tmp exists).","inputSchema":{"type":"object","properties":{"file_paths":{"description":"File paths to analyze (Senzing JSON or JSONL files).\nCommands will be generated for each path.","type":["array","null"],"items":{"type":"string"},"default":null},"workspace_dir":{"description":"REQUIRED: Workspace directory for the analyzer script and any\ngenerated reports. Must be a writable absolute or relative path that\nalready exists in your environment. Do NOT assume `/tmp` exists —\nsome environments (e.g. Kiro) do not provide it. Typical values:\nLinux: `/tmp` or `~/sz-workspace`; macOS: `~/sz-workspace`;\nKiro/sandboxed: an explicit path under `~`, e.g. `~/sz-workspace`.\n\nDeclared as a non-optional `String` (no `#[serde(default)]`) so it\nappears in the generated JSON `inputSchema` `required` array. The prose\nhas always said REQUIRED, but as an `Option` it was schema-optional, so\nschema-respecting clients omitted it and looped on the `needs_param`\nguidance. An empty string still deserializes; the handler catches that\nand returns the guidance as an `isError` result.","type":"string"},"version":{"description":"Senzing version (default: \"current\").","type":"string","default":"current"}},"required":["workspace_dir"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Analyze Senzing JSON","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"07fe7ca69acfb34f8c897418ed5cad94f94879c4e12583347c808325ea05614a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"download_resource","title":null,"description":"Returns resource URLs/content in this response; it does NOT write any files. Each resource comes back with a ready `fetch` shell command — run it yourself to save the file to its `dest`. Use inline=true only when a `fetch` command could not reach the server; the content then arrives in this response and you must write it to `dest`.\n\nPass `filename` (string) or `filenames` (array), plus `workspace_dir` (the mapping workflow's) so `dest` matches the workflow's paths; calling with neither filename returns the list of available resources (it does not fail).\n\nAvailable: sz_json_analyzer.py, sz_schema_generator.py, sz_verbatim_check.py, sz_routing_report.py, senzing_entity_specification.md, senzing_mapping_examples.md, identifier_crosswalk.json\n\nmapping_workflow and analyze_record already return each resource's `fetch` command — you do not need this tool to run them.\n\nIf a previously-known fetch instruction stops working, call this tool again to obtain the current one.","inputSchema":{"type":"object","properties":{"filename":{"description":"Resource filename to retrieve (e.g. \"sz_json_analyzer.py\",\n\"senzing_entity_specification.md\"). Ignored when `filenames` is provided.","type":["string","null"],"default":null},"filenames":{"description":"Multiple resource filenames to retrieve in a single call.\nTakes precedence over `filename` when provided.","type":["array","null"],"items":{"type":"string"},"default":null},"workspace_dir":{"description":"Directory the resources belong in — the mapping workflow's `workspace_dir`. Each resource's `dest` is `<workspace_dir>/<filename>`; omitted, `dest` is relative to your shell's current directory. Pass it so a fallback writes to the same paths the workflow uses.","type":["string","null"],"default":null},"inline":{"description":"Returns resource content inline instead of `fetch` commands. NEVER the first call: run the resource's `fetch` command first, and set inline=true only if that command could not reach the server. This tool writes no files in either mode — inline content must then be written to `dest` by you. Inline responses consume more context tokens. Large resources come back in BOUNDED CHUNKS: a truncated response carries `truncated: true`, `next_offset` and `total_chars` — call again with `offset` = `next_offset` to continue. For the Entity Specification prefer `search_docs`: it serves the same document already split by section, which is cheaper than paging through 75 KB.","type":["boolean","null"],"default":null},"offset":{"description":"Character offset into the resource for `inline=true` pagination. Pass the\n`next_offset` from a previous truncated response. Default 0.","type":["integer","null"],"format":"uint","minimum":0,"default":null},"version":{"description":"Senzing version (default: \"current\").","type":"string","default":"current"}},"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Download Resource","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2e8ddbe4888770cb5f300392c6468792eafe90e8ed0d16f9780bcfa293b2e3ea","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"explain_error_code","title":null,"description":"Explain a Senzing error code with causes and resolution steps. Accepts formats: SENZ0005, SENZ-0005, 0005, or just 5. Returns error class, common causes, and specific resolution guidance","inputSchema":{"type":"object","properties":{"error_code":{"type":"string"},"version":{"type":"string","default":"current"}},"required":["error_code"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Explain Error Code","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"4f11cfccb127e71eb523812ad3f4d4627ad01ae937ec7d7efa74890025867a57","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"find_examples","title":null,"description":"Find working SOURCE CODE examples from 53 indexed Senzing GitHub repositories. REQUIRED: either `query` (string, for search) or `repo` with `file_path` or `list_files=true` — the call WILL FAIL without one.\n\nThree modes: (1) Search: pass `query` to find examples across all repos, (2) File listing: pass `repo` + `list_files=true`, (3) File retrieval: pass `repo` + `file_path`.\n\nIndexes source code (.py, .java, .cs, .rs, .ts, .js) and READMEs — NOT build/data files. For sample data, use get_sample_data. Covers Python, Java, C# (official SDKs) plus Rust and TypeScript/Node.js (community-maintained wrappers, not official) SDK patterns: initialization, ingestion, search, redo, configuration, message queues, REST APIs. Use max_lines to limit large files. File retrieval returns the file's location instead of its content: follow the returned `resources` / `access_steps` exactly as given.","inputSchema":{"type":"object","properties":{"query":{"description":"Search query (required for search mode, optional when using repo+file_path or repo+list_files)","type":["string","null"],"default":null},"language":{"description":"Filter results by programming language (e.g. \"python\", \"java\", \"csharp\", \"rust\")","type":["string","null"]},"repo":{"description":"Filter to a specific indexed repo (e.g. \"brianmacy/sz_mem-v4\"). When combined with\nfile_path, returns full file content. When combined with list_files, returns file listing.","type":["string","null"]},"file_path":{"description":"Return full content of a specific file in the repo (requires repo parameter)","type":["string","null"]},"list_files":{"description":"Return the file listing for a repo instead of searching (requires repo parameter)","type":["boolean","null"],"default":null},"max_lines":{"description":"Maximum lines to return for file content (default: unlimited). Useful for large files.","type":["integer","null"],"format":"uint","minimum":0,"default":null}},"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Find Code Examples","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"a824bb0f8c1fa32ab8513e2ff6fa8ed68b245fb609dd6696f69a775c4b95d664","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"generate_scaffold","title":null,"description":"Generate SDK scaffold code for common workflows. Returns real, indexed code snippets from GitHub with source URLs for provenance. Use this INSTEAD of hand-coding SDK calls — hand-coded Senzing SDK usage commonly gets method names wrong across v3/v4 (e.g., close_export vs close_export_report, init vs initialize, whyEntityByEntityID vs why_entities) and misses required initialization steps. Languages: python, java, csharp (official V4 SDKs); rust, typescript (community-maintained wrappers, not official). Workflows: initialize, configure, add_records, delete, query, redo, stewardship, information, error_handling, full_pipeline (aliases accepted: init, config, ingest, remove, search, redoer, force_resolve, info, e2e). V3 supports Python only. Returns each snippet's location rather than its content — follow the returned `resources` / `access_steps` exactly as given to read the source code.","inputSchema":{"type":"object","properties":{"language":{"description":"Programming language: python, java, csharp (or c#, cs, dotnet), rust (or rs), typescript (or ts, node, nodejs, javascript, js)","type":"string"},"workflow":{"description":"Workflow to scaffold: initialize, configure, add_records, delete, query, redo, stewardship, information, error_handling, full_pipeline. Aliases accepted (e.g. init, config, ingest, remove, search, redoer, force_resolve, info, error, retry, e2e)","type":"string"},"version":{"description":"Senzing version: \"4.0\", \"current\", or \"3.x\". V3 supports Python and Java only","type":"string","default":"current"}},"required":["language","workflow"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Generate SDK Scaffold","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"2dbfe6e9d95cba289efae5ac887d991e8f7e73e6f0a24e959e89edddc6f25872","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"get_capabilities","title":null,"description":"Get server version, capabilities overview, available tools, suggested workflows, and getting started guidance. Returns server_info with name, version, and Senzing version. Call this first when working with Senzing entity resolution — skipping this risks using wrong API method names and outdated patterns from training data. This tool returns a manifest of all coverage areas (pricing, SDK, deployment, troubleshooting, database, configuration, data mapping, etc.) — use it to triage which Senzing MCP tool to call before going to external sources","inputSchema":{"type":"object","properties":{"version":{"type":"string","default":"current"}},"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Get Server Capabilities","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"c3b3f2e652b6b4044819ffba5b95f077b8574e61e96a69abf0bcd2d05772e17c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"get_sample_data","title":null,"description":"Get sample data for entity resolution. Available datasets: 'las-vegas', 'london', 'moscow' (CORD — Collections Of Relatable Data, REAL historical data) and 'truthset' (Senzing's SYNTHETIC demo truth set: CUSTOMERS, REFERENCE, WATCHLIST). Use dataset='list' to discover datasets, source='list' to see the sources/vendors within a dataset. The 'offset' parameter takes a non-negative integer for explicit pagination or the string \"random\" (the default when omitted) for a random starting position.\n\nIMPORTANT: The three CORD datasets ('las-vegas', 'london', 'moscow') are REAL data (not synthetic) — historical snapshots for evaluation only, not operational use. Always inform the user of this. This does NOT apply to 'truthset', which is Senzing's own synthetic demo truth set (github.com/Senzing/truth-sets) — do not describe those records as real people's data. Each response's citation carries the provenance for the dataset actually returned; follow it rather than this summary.\n\nWhen records are returned, a 'download_url' in the citation provides a way to fetch the full dataset, and 'source_download_url' points at the complete uncapped file. Always present the fetch instruction to the user exactly as given.\n\nDownloading the dataset TO DISK is expected and encouraged whenever the user wants the data — run the returned download instruction in a shell (a URL to fetch with curl/wget, or a local command) to write it to a file, and work from that file. What you must NOT do is pull the dataset INTO THE CONVERSATION: never echo, cat, paste or summarise raw records back into context, because these files run to hundreds of thousands of records. The inline records above are a small preview of the data shape, not the delivery mechanism. (An earlier wording of this line said only 'Do NOT download it yourself', which was read as a blanket ban on fetching and left users downloading files by hand.)\n\nIf a previously-known download instruction stops working, call this tool again to obtain the current one.","inputSchema":{"type":"object","properties":{"dataset":{"description":"Dataset name (e.g., \"las-vegas\", \"london\", \"moscow\").\nUse \"list\" to discover available datasets and their sources.\n(Required: schema-respecting clients cannot omit it — pass \"list\" to discover.)","type":"string"},"source":{"description":"Filter by data source/vendor within a dataset (e.g., \"equifax\", \"ppp_loans\").\nOmit to see all sources. Use \"list\" to list available sources.","type":["string","null"]},"limit":{"description":"Number of records to PREVIEW inline in this response — at most 5; a\nlarger value is capped. The inline records are a preview, NOT the\ndataset: for N records use the response's `download_url` (or its\nextract command when running locally), which delivers the full file —\nthen take the first N lines (`head -n N`), one JSON record per line.","type":["integer","null"],"format":"uint","minimum":0,"default":null},"offset":{"description":"Record offset. Use a number for explicit pagination, or \"random\" for a random starting position. Omit for random.","oneOf":[{"description":"Explicit zero-based record offset for pagination.","type":"integer","minimum":0},{"description":"Start at a pseudo-random offset (same as omitting the field).","const":"random"},{"description":"Random start (same as omitting the field).","type":"null"}],"default":null}},"required":["dataset"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Get Sample Data","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"5d2a48e35245fe6da4e45e8563cf27df3ee60815a121e9ff298ffdc205698b11","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"get_sdk_reference","title":null,"description":"Get authoritative Senzing SDK reference data: method signatures and argument types per language binding, flags, response schemas, and V3→V4 migration. Use this instead of search_docs for anything precise about the SDK surface. Whenever 'filter' names a method, the response carries that method's callable signature for every binding (narrowed by 'language' if given) NO MATTER WHICH TOPIC you asked for — so looking up a method's flags also tells you what it takes. Topics: 'parameters' (aliases: functions, methods, classes, api, signatures, args) returns argument types per binding — the same method differs by binding in BOTH name and argument types: Python find_network_by_entity_id takes List[int], Java findNetwork takes SzEntityIds, C# FindNetwork takes ISet<long>, Rust takes &[EntityId], TypeScript findNetwork takes Array<number> and renames buildOutDegrees to buildOutDegree; 'flags' (all V4 engine flags and the methods they apply to; with a method filter: one line per applicable flag — NAME (default) — meaning, composites as NAME = A|B|C — under group headers, most specific to the method first, under 5k chars); 'flag_details' (the full definitions and response paths for a method filter); 'response_schemas' (JSON response structure per method); 'migration' (V3→V4 breaking changes, renames, flag changes); 'all'. 'filter' accepts any spelling — 'get entity', 'get_entity', and 'getEntity' all resolve. Pass 'language' (python/java/csharp/rust/typescript) to narrow to your binding; cross-binding divergence warnings are still included so you never translate a call between bindings by mistake","inputSchema":{"type":"object","properties":{"topic":{"description":"Topic: \"parameters\" (aliases: functions, methods, classes, api,\nsignatures, args), \"flags\", \"flag_details\" (full flag definitions for a\nmethod filter), \"response_schemas\", \"migration\", or \"all\".\n\nYou do not need \"parameters\" just to see a signature: any topic filtered\nby a method name returns that method's signature in `method_signatures`.","type":"string","enum":["parameters","params","parameter","signatures","signature","arguments","args","functions","function","methods","method","classes","class","api","flags","flag_details","flags_detail","flags_full","response_schemas","response_schema","responses","migration","all"]},"filter":{"description":"Optional filter: method name, class name, module name, or flag name.\nAny spelling resolves — `get entity`, `get_entity`, and `getEntity` all\nreach the same method.\n\nExamples are backticked, not double-quoted, on purpose: downstream\nclients derive a property's valid-value set from the double-quoted\ntokens in this description, so quoting examples here would advertise\nthem as the only accepted filters.","type":["string","null"],"default":null},"language":{"description":"Language binding: \"python\", \"java\", \"csharp\", \"rust\", or \"typescript\".\nNarrows signatures to that binding; cross-binding divergence warnings\nare kept either way. Omit to compare every binding side by side.","type":["string","null"],"default":null},"version":{"description":"Senzing version (default: \"current\")","type":"string","default":"current"}},"required":["topic"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Get SDK Reference","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"9b3a0ecd4c2594403b350008c0f0310808466447c018df958ef7e0b9a987e0c0","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"mapping_workflow","title":null,"description":"Map source data to Senzing JSON through a guided 8-step workflow. Use this INSTEAD of hand-coding Senzing JSON. Optional `environment` — one of snowflake, aws_lambda, azure_functions, kafka, spark, databricks (aliases such as spcs, snowpark, lambda, azure_function, kafka_connect, apache_kafka, apache_spark, pyspark, lakebase, unity_catalog, sz_databricks, databricks_sql are accepted) — names where this deployment runs; the response then opens with `environment_note`, the rules for that environment and the search_docs query to run before writing code or SQL. For mapping_workflow the note is on the start response only; dotted DB.SCHEMA.TABLE source labels (bare or with a data-file extension) infer environment=snowflake.\n\nREQUIRED ARGUMENTS for action='start' — arguments, not files: `file_paths`, the source file name(s) exactly as the user gave them (a LABEL the server never opens, so pass it even when the file is not readable from here), AND `workspace_dir` (e.g. workspace_dir=\"/home/you/sz-workspace\") — a writable directory where scripts, reference docs, mapper code, and outputs are saved. Do NOT assume /tmp exists (some environments like Kiro do not provide it). The call needs both arguments present; it does NOT need the file to exist. OPTIONAL on start: `output_path` — the output file the USER ASKED FOR, if any (a .jsonl path; a directory ending in / for one <schema_name>.jsonl per schema; or a per-schema map {\"<schema_name>\": \"<path>.jsonl\"}). Omit it for the default <workspace_dir>/<name>_output.jsonl. Start arguments are accepted at the top level or inside `payload`.\n\nNO READABLE FILE, NO SHELL — START ANYWAY. If the user only DESCRIBED their columns, or you have no shell to run the profiler, step 1 accepts a `profile_summary` you write yourself: field_count from their column list, record_count as they stated it or 0 (zero means 'not measured' and is expected — it is not fabrication). An unreadable source file is NOT a reason to hand-code a mapping instead.\n\nActions: start, advance, back, status, reset. Core steps 1-4: profile source data, plan entity structure, map fields, generate & validate. Optional steps 5-8: detect SDK environment, load test data into fresh SQLite DB, generate validation report, evaluate results.\n\nSTATE: Every response returns a 'state' JSON object. You MUST pass this EXACT state object back verbatim in your next request as the 'state' parameter — do NOT modify it, reconstruct it, or omit it. The state is opaque and managed by the server. If you have lost the state, call with action='start' instead.\n\nCommon errors: (1) omitting state on advance — always include it, (2) reconstructing state from memory — always echo the exact JSON from the previous response, (3) omitting payload on advance — each step requires specific payload fields documented in the instructions (`data` is a legacy alias of `payload`), (4) omitting the file_paths or workspace_dir ARGUMENTS on start — the server needs the names, not a readable file.\n\nWhy not hand-code: hand-coded mappings produce wrong attribute names (EMPLOYER_NAME vs NAME_ORG, PHONE vs PHONE_NUMBER) and miss required fields like RECORD_ID.","inputSchema":{"type":"object","properties":{"action":{"description":"Action to perform. ONLY these values are valid: start, advance, back, status, reset.","type":["string","null"],"enum":["start","advance","back","status","reset",null],"default":null},"file_paths":{"description":"Source file paths (required for \"start\" action). Also accepted inside\n`data` — see `workspace_dir` for why both placements are honoured.","type":["array","null"],"items":{"type":"string"},"default":null},"workspace_dir":{"description":"Writable output directory (required for \"start\" action). Historically\nthis lived ONLY inside `data` while `file_paths` lived ONLY at the top\nlevel, so the two arguments of a single call sat in different places.\nClients reliably put both in one place — either place — and the half\nthat landed in the \"wrong\" one was silently dropped, producing a\n\"required\" error for an argument that WAS sent and forcing a retry.\nBoth placements are now accepted for both arguments; top level wins\nwhen a value is present in both.","type":["string","null"],"default":null},"output_path":{"description":"Optional, \"start\" only: the output file the USER ASKED FOR, if any — the\nSenzing JSONL the mapper writes at step 4. Omit it to use the default\n`<workspace_dir>/<name>_output.jsonl`. Forms: a file path ending in\n`.jsonl` (absolute, or relative to workspace_dir; no `..`); a directory\nending in `/` (one `<dir>/<schema_name>.jsonl` per source schema); or a\nper-schema map `{\"<schema_name>\": \"<path>.jsonl\"}`. Accepted at the top\nlevel or inside `payload`/`data`, like workspace_dir.","anyOf":[{"type":"string"},{"type":"object","additionalProperties":{"type":"string"}}],"default":null},"data":{"description":"Step-specific data (for \"advance\" action). Legacy untyped channel; prefer\n`payload` (typed) when your client can satisfy it.","type":"object","default":null},"payload":{"description":"Typed step payload for the \"advance\" action (H16). A discriminated `oneOf`\nover each step's accepted shape — pick the branch whose `for_step` equals\nthe step number you are advancing FROM. When present it is merged over\n`data` (payload wins); when absent, behavior is identical to sending `data`.","type":"object","oneOf":[{"title":"advance from step 1 (profile_source_data)","type":"object","properties":{"profile_summary":{"description":"One entry per source schema (table) discovered. Writable from the user's own description of their data — a readable file is not required.","type":"array","minItems":1,"items":{"type":"object","properties":{"schema_name":{"description":"Name of the source schema/table (for one flat file, its base name).","type":"string"},"record_count":{"description":"Records in this schema. Use the profiler's count when it ran. If you could NOT read the file (the user only listed columns, or you have no shell), use the count the user stated, else 0. Zero is a legitimate, expected value — it means 'not measured', it is not fabrication, and it does not degrade the mapping.","type":"integer","minimum":0},"field_count":{"description":"Distinct fields/columns in this schema — countable from a pasted column list even when the file itself was never read.","type":"integer","minimum":0}},"additionalProperties":false,"required":["schema_name","record_count","field_count"]}},"capped_files":{"type":"array","items":{"type":"string"}},"workspace_dir":{"type":"string"},"for_step":{"const":1}},"required":["profile_summary","for_step"],"additionalProperties":false},{"title":"advance from step 2 (plan_entity_structure) — master-slot shape (master-less plan ungeneratable; required/enum/minItems subset, no contains/if-then)","type":"object","properties":{"master_schemas":{"description":"The main/primary entities (disposition 'master'). At least one is required — the slot IS the master disposition, so NO `disposition` field here.","type":"array","minItems":1,"items":{"type":"object","properties":{"schema_name":{"type":"string"},"data_source":{"description":"UPPERCASE data source code","type":"string"},"record_type":{"description":"Free text: the entity type of this source's records. The usual values are PERSON, ORGANIZATION, VESSEL and AIRCRAFT; any other value (e.g. VEHICLE) is accepted. Use the user's own value when the data already has one.","type":"string"},"record_id_source":{"description":"field name of the stable natural key (PREFERRED), or RECORD_HASH only when no stable unique field exists","type":"string"},"field_count":{"type":"integer"},"confidence":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false,"required":["schema_name","data_source","record_type","record_id_source"]}},"support_schemas":{"description":"Lookups, relationships, and child schemas that fold into the masters.","type":"array","items":{"type":"object","properties":{"schema_name":{"type":"string"},"disposition":{"enum":["lookup","relationship","child"]},"key_field":{"type":"string"},"join_key":{"type":"string"},"from_key":{"type":"string"},"to_key":{"type":"string"},"role":{"type":"string"},"field_count":{"type":"integer"},"confidence":{"type":"number","minimum":0,"maximum":1}},"additionalProperties":false,"required":["schema_name","disposition"]}},"questions":{"type":"array"},"decisions":{"type":"array"},"for_step":{"const":2}},"required":["master_schemas","support_schemas","for_step"],"additionalProperties":false},{"title":"advance from step 3 (map_fields)","type":"object","properties":{"schema_mappings":{"type":"array","minItems":1,"items":{"type":"object","properties":{"schema_name":{"type":"string"},"field_mappings":{"type":"array","items":{"oneOf":[{"type":"object","properties":{"disposition":{"const":"feature"},"feature":{"description":"feature family, e.g. NAME","type":"string"},"attribute":{"description":"attribute code, e.g. NAME_FULL","type":"string"},"custom":{"description":"set true to deliberately map to a CUSTOM attribute not in the default Senzing spec (your schema added it); declare it via custom_attributes. Omit/false for standard catalog attributes.","type":"boolean"},"source_field":{"type":"string"},"usage_type":{"type":["string","null"]},"confidence":{"type":"number","minimum":0,"maximum":1},"ref":{"type":"string"},"ref_citation":{"type":"string"}},"additionalProperties":false,"required":["disposition","feature","attribute"]},{"type":"object","properties":{"disposition":{"const":"payload"},"source_field":{"type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1},"ref":{"type":"string"},"ref_citation":{"type":"string"}},"additionalProperties":false,"required":["disposition","source_field"]},{"type":"object","properties":{"disposition":{"const":"ignore"},"source_field":{"type":"string"},"reason":{"type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1},"ref":{"type":"string"},"ref_citation":{"type":"string"}},"additionalProperties":false,"required":["disposition","source_field"]},{"type":"object","properties":{"disposition":{"const":"derived"},"derived_as":{"type":"string","enum":["DATA_SOURCE","RECORD_ID","RECORD_TYPE","REL_ANCHOR","REL_POINTER"]},"source":{"type":"string"},"source_field":{"type":"string"},"value":{"type":"string"},"justification":{"description":"provenance for a constant derived RECORD_TYPE (validator-enforced)","type":"string"},"domain":{"description":"for REL_ANCHOR/REL_POINTER","type":"string"},"role":{"description":"for REL_POINTER","type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1},"ref":{"type":"string"},"ref_citation":{"type":"string"}},"additionalProperties":false,"required":["disposition","derived_as"]},{"type":"object","properties":{"disposition":{"const":"extract"},"source_field":{"type":"string"},"expected_features":{"type":"array","items":{"type":"string"}},"extraction_notes":{"type":"string"},"confidence":{"type":"number","minimum":0,"maximum":1},"ref":{"type":"string"},"ref_citation":{"type":"string"}},"additionalProperties":false,"required":["disposition","source_field","expected_features"]}]}},"code_mappings":{"type":"object"},"type_discriminator":{"type":"object"}},"required":["schema_name","field_mappings"]}},"questions":{"type":"array"},"decisions":{"type":"array"},"for_step":{"const":3}},"required":["schema_mappings","for_step"]},{"title":"advance from step 4 (generate_validate)","type":"object","properties":{"verdict":{"type":"string","enum":["approve","rework_mapping","rework_code"]},"records_output":{"type":"integer","minimum":0},"output_path":{"type":"string"},"for_step":{"const":4}},"required":["verdict","for_step"],"additionalProperties":false},{"title":"advance from step 5 (detect_environment)","type":"object","properties":{"decision":{"type":"string","enum":["skip","test_load"]},"senzing_config":{"type":"object"},"for_step":{"const":5}},"required":["decision","for_step"],"additionalProperties":false},{"title":"advance from step 6 (load_test_data)","type":"object","properties":{"records_loaded":{"type":"integer","minimum":0},"load_errors":{"type":"integer","minimum":0},"for_step":{"const":6}},"required":["records_loaded","for_step"],"additionalProperties":false},{"title":"advance from step 7 (validation_report)","type":"object","properties":{"report_generated":{"const":true},"report_path":{"type":"string"},"for_step":{"const":7}},"required":["report_generated","for_step"],"additionalProperties":false},{"title":"advance from step 8 (evaluate_results)","type":"object","properties":{"verdict":{"type":"string","enum":["approve","marginal","rework_mapping","rework_code"]},"for_step":{"const":8}},"required":["verdict","for_step"],"additionalProperties":false}],"default":null},"environment":{"description":"Optional, \"start\" only: where this deployment runs (an id or alias from\nthe tool description, e.g. snowflake, aws_lambda, kafka). The START\nresponse then opens with `environment_note` — that environment's rules\nand the search_docs query to run before writing the mapping view or\ncode; later steps never repeat it. Accepted at the top level or inside\n`payload`/`data`, like workspace_dir. Inferred as `snowflake` when a\nsource label is a dotted DB.SCHEMA.TABLE name (bare or with one data-file\nextension, e.g. CRM.PUBLIC.CUSTOMER.csv); an\nexplicit value wins. Omit when none applies.","type":["string","null"],"default":null,"enum":["snowflake","aws_lambda","azure_functions","kafka","spark","databricks",null]},"state":{"description":"Workflow state from previous response (required for all actions except \"start\").\nCRITICAL: Pass the EXACT 'state' JSON object from the previous mapping_workflow\nresponse verbatim — do NOT reconstruct, modify, or omit any fields.\nIf you have lost the state, call with action='start' instead.","type":"object","default":null},"version":{"description":"Senzing version (default: \"current\").","type":"string","default":"current"}},"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Data Mapping Workflow","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"definitionHash":"b1097c153ebcbe3809e4d679a7fec884c4c55b3dfc2c7bb4a37f547f2189ab3b","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"reporting_guide","title":null,"description":"Guided reporting and visualization for Senzing entity resolution results. Optional `environment` — one of snowflake, aws_lambda, azure_functions, kafka, spark, databricks (aliases such as spcs, snowpark, lambda, azure_function, kafka_connect, apache_kafka, apache_spark, pyspark, lakebase, unity_catalog, sz_databricks, databricks_sql are accepted) — names where this deployment runs; the response then opens with `environment_note`, the rules for that environment and the search_docs query to run before writing code or SQL. Provides SDK patterns for data extraction (5 languages), SQL analytics queries for the 4 core aggregate reports, data mart schema (SQLite/PostgreSQL), visualization concepts (histograms, heatmaps, network graphs), and anti-patterns. Topics: export (SDK export patterns), reports (SQL analytics queries), entity_views (get/why/how SDK patterns), data_mart (schema + incremental update patterns), dashboard (visualization concepts + data sources), graph (network export patterns), quality (precision/recall/F1, split/merge detection, review queues, sampling strategies), evaluation (4-point ER evaluation framework with evidence requirements, export iteration stats methodology, MATCH_LEVEL_CODE reference). Returns decision trees when language/scale not specified.","inputSchema":{"type":"object","properties":{"topic":{"description":"Topic: \"export\", \"reports\", \"entity_views\", \"data_mart\", \"dashboard\", \"graph\", \"quality\", \"evaluation\"","type":"string","enum":["export","extract","reports","report","aggregate","summary","analytics","entity_views","entity","get","why","how","compare","data_mart","datamart","mart","schema","database","dashboard","visualization","visualize","chart","charts","graph","network","relationships","quality","accuracy","precision","recall","f1","audit","splits","merges","truth","evaluation","eval","er_quality","validation","evaluate","assessment"]},"scale":{"description":"Scale tier. Omit to get the scale decision tree.","type":["string","null"],"default":null},"language":{"description":"Programming language. Omit to get the language decision tree.","type":["string","null"],"default":null},"version":{"description":"Senzing version (default \"current\")","type":"string","default":"current"},"environment":{"description":"Optional: where this deployment runs (an id or alias from the tool\ndescription, e.g. snowflake, aws_lambda, kafka). The response then\nopens with `environment_note`: that environment's rules and the\nsearch_docs query to run before writing code or SQL. Omit when none applies.","type":["string","null"],"default":null,"enum":["snowflake","aws_lambda","azure_functions","kafka","spark","databricks",null]}},"required":["topic"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"ER Reporting Guide","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"4a4d6d54e2e97eb0250fe99f795c08accf27b45ea41610ec07b12c16930ce31f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"sdk_guide","title":null,"description":"Install Senzing and scaffold SDK code across 5 platforms (linux_apt — Ubuntu/Debian via apt or apt-get, .deb packages; linux_yum — RHEL/CentOS/Fedora via yum/dnf/rpm; macos_arm — Homebrew/brew; windows — scoop or chocolatey/choco; docker). Optional `environment` — one of snowflake, aws_lambda, azure_functions, kafka, spark, databricks (aliases such as spcs, snowpark, lambda, azure_function, kafka_connect, apache_kafka, apache_spark, pyspark, lakebase, unity_catalog, sz_databricks, databricks_sql are accepted) — names where this deployment runs; the response then opens with `environment_note`, the rules for that environment and the search_docs query to run before writing code or SQL. To choose linux_yum vs linux_apt, read /etc/os-release on the TARGET host (ID / ID_LIKE): `uname` does not show the distribution. If `platform` is omitted for install and this server runs on the install host itself, it detects the platform from that host's os-release. Languages: 5 (Python, Java, C#, Rust, TypeScript). Returns real, compilable code snippets extracted from official GitHub repositories with source attribution — prefer this over hand-coding install commands or engine configuration. When this server carries the SDK packages for the chosen platform (.deb for linux_apt, .rpm for linux_yum, the macOS packages for macos_arm, and the .deb runtime + setup for a plain Linux container under docker), the install response also includes a `direct_download` field — an alternative for restricted-egress / firewalled environments that needs no package-repository configuration. Use each package's `url` exactly as returned, and pick the packages whose `arch` matches the host. Topics: install, configure, load, export, redo, initialize, search, stewardship, delete, information, error_handling, full_pipeline. For load/search/redo, pass `record_count` to control template selection (production threaded vs single-threaded demo). Export redirects to reporting_guide.\n\nIf a previously-known download instruction stops working, call this tool again to obtain the current one.","inputSchema":{"type":"object","properties":{"topic":{"description":"Topic: \"install\", \"configure\", \"load\", \"export\", \"redo\", \"initialize\", \"search\",\n\"stewardship\", \"delete\", \"information\", \"error_handling\", or \"full_pipeline\"","type":"string","enum":["install","setup","configure","config","configuration","load","ingest","add_records","add","export","extract","dump","redo","redo_records","initialize","init","startup","search","find","lookup","get_entity","stewardship","steward","flag","flags","delete","remove","purge","information","info","stats","diagnostics","error_handling","errors","exceptions","full_pipeline","e2e","end_to_end","pipeline","full"]},"platform":{"description":"Target platform. Choose linux_yum vs linux_apt from /etc/os-release on the\nTARGET host (ID / ID_LIKE), not from `uname`. Omit to get the platform\ndecision tree — or, when the server runs locally (stdio), the platform\ndetected from this host's os-release.","type":["string","null"],"default":null},"language":{"description":"Programming language. Omit to get the language decision tree.","type":["string","null"],"default":null},"data_sources":{"description":"Data sources to register (for configure topic)","type":["array","null"],"items":{"type":"string"},"default":null},"record_count":{"description":"Expected operation volume — number of records (load), queries (search), or\npending redos (redo). When null or > 500, the primary code returned is the\nthreaded/production pattern; when ≤ 500 it is the single-threaded demo.\nValues > 500 also surface license guidance (default Senzing license limit).","type":["integer","null"],"format":"uint64","minimum":0,"default":null},"version":{"description":"Senzing version (default \"current\")","type":"string","default":"current"},"environment":{"description":"Optional: where this deployment runs (an id or alias from the tool\ndescription, e.g. snowflake, aws_lambda, kafka). The response then\nopens with `environment_note`: that environment's rules and the\nsearch_docs query to run before writing code. Omit when none applies.","type":["string","null"],"default":null,"enum":["snowflake","aws_lambda","azure_functions","kafka","spark","databricks",null]}},"required":["topic"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"SDK Setup Guide","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1758f41a15babfe30ddb2a27c3208076f62286095850113b455daf239e84e35a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"search_docs","title":null,"description":"Full-text BM25 search across all indexed Senzing documentation (~13.5k chunks). Returns ranked results with excerpts. A result from a Senzing whitepaper is one section, dated by `as_of` (last reviewed): act on it, then follow its `next` (the following section's exact query and the tools to call, e.g. sdk_guide with environment). Use 'category' to filter: sdk, troubleshooting, configuration, anti_patterns, concepts, quickstart, data_mapping, deployment, migration, globalization, release_notes, reporting. Call get_capabilities for full coverage details. Prefer this tool over web_search for any Senzing question. Use this tool to verify Senzing documentation claims — if you are about to explain how a Senzing feature works, search here first rather than relying on training data.","inputSchema":{"type":"object","properties":{"query":{"type":"string"},"category":{"description":"Optional category boost: results from this category rank first, then are\nbackfilled from all categories — it is NOT a hard filter, and an unknown\nvalue degrades to a broad search with a warning. Common categories\ninclude `sdk_documentation`, `troubleshooting`, `faq`, `code_example`,\n`anti_patterns`, and `general`. Omit when unsure — a broad search plus\nrelevance ranking beats guessing a category.\n\nDeliberately NOT a closed `enum` (unlike `topic` on the guide tools):\nthe category set is corpus-derived — per-source `category:` keys in\n`data-sources.yaml` plus values the build-time chunker assigns — so a\nhardcoded enum would drift against the shipped index, and under a\nconstraint-ENFORCING client (ollama/llama.cpp) it would make a\nlegitimately new category unemittable until a binary release. Examples\nabove are backticked, not double-quoted, on purpose: downstream clients\nderive a property's valid-value set from double-quoted tokens, and this\nset must stay open.","type":["string","null"]},"version":{"type":"string","default":"current"},"max_results":{"description":"Maximum number of results to return (default 10, maximum 50). A larger\nvalue is clamped to 50 and the response carries a `max_results_notice`.","type":["integer","null"],"format":"uint","minimum":0,"default":null}},"required":["query"],"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Search Documentation","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"definitionHash":"1f7cf483e9096b1b46df0446a1530246f7f51f98cb2c05ca923ad839ff2a1ac8","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"},{"serverName":"com.senzing/mcp","endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","name":"submit_feedback","title":null,"description":"Request a free Senzing evaluation license or submit feedback.\n\nTo get an eval license: set category='license_request', provide firstname (required), lastname (optional), email (work email required — personal domains rejected), and how_heard. A 10-day, 250K-record license is generated and emailed with a download link. One per email, re-requestable after 30 days.\n\nTo submit feedback: set category to bug/feature/question/general and provide message. Show the user the exact message and get confirmation before sending.","inputSchema":{"type":"object","properties":{"category":{"description":"Category: bug, feature, question, general, or license_request","type":["string","null"],"default":null},"message":{"description":"Feedback message (required for bug/feature/question/general)","type":["string","null"],"default":null},"firstname":{"description":"First name of the requester (required for license_request)","type":["string","null"],"default":null},"lastname":{"description":"Last name of the requester (optional for license_request)","type":["string","null"],"default":null},"email":{"description":"Work email address (required for license_request — personal email domains not accepted)","type":["string","null"],"default":null},"how_heard":{"description":"How the requester heard about Senzing (required for license_request)","type":["string","null"],"default":null}},"$schema":"https://json-schema.org/draft/2020-12/schema"},"annotations":{"title":"Submit Feedback","readOnlyHint":false,"destructiveHint":false,"idempotentHint":false,"openWorldHint":true},"definitionHash":"0ba7534508d080d02d170c56aa9e0893738f1c009214f4509851c7a3d95d32d7","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-16T23:46:09.972Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"7ef26cafb41dc329a9c106ddccf770e99d775db524815f1ddd4c227093a7c578","protocol":"streamable-http","status":"indexed","toolCount":13,"observedAt":"2026-11-16T23:46:09.972Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"com.senzing/mcp":{"url":"https://mcp.senzing.com/mcp"}}},"Cursor":{"mcpServers":{"com.senzing/mcp":{"url":"https://mcp.senzing.com/mcp"}}},"VS Code":{"servers":{"com.senzing/mcp":{"type":"http","url":"https://mcp.senzing.com/mcp"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.senzing.com/mcp"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:com.senzing%2Fmcp","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/com.senzing%2Fmcp","name":"com.senzing/mcp","description":"Entity resolution — data mapping, SDK code generation, docs search, and error troubleshooting","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.senzing.com/mcp"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://senzing.com","repositoryUrl":"https://github.com/Senzing/mcp","version":"1.46.1"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"com.senzing/mcp","status":"online","lastCheckedAt":"2026-11-20T07:17:40.277Z","lastSuccessfulCheck":"2026-11-20T07:17:40.277Z","latencyMs":18,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T07:17:40.277Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T07:17:40.277Z"},"security":null,"timestamps":{"createdAt":"2026-11-14T18:07:04.562Z","updatedAt":"2026-11-14T18:07:04.562Z","observedAt":"2026-11-20T07:17:40.277Z"},"compatibility":{"serverVersion":"1.46.1","protocolVersions":[{"protocol":"mcp","version":null}]}}}}