Senzing MCP Server — Documentation

Overview

The Senzing MCP server provides AI assistants with entity resolution capabilities through the Model Context Protocol. It offers 14 tools and 13 prompts for data mapping, SDK code generation, ER reporting and visualization, documentation search, error troubleshooting, and sample data access.

The server works entirely from pre-fetched documentation and indexed content. It never connects to live Senzing instances, never handles PII, and requires no authentication.

Setup

No authentication is required. Connect the server to your MCP client:

Claude Code

claude mcp add --transport http senzing https://mcp.senzing.com/mcp

Claude Desktop / Other MCP Clients

Add to your MCP configuration:

{
  "mcpServers": {
    "senzing": {
      "type": "url",
      "url": "https://mcp.senzing.com/mcp"
    }
  }
}

Verify Connection

After connecting, ask your AI assistant: "What can this Senzing MCP server do?" — this calls get_capabilities and confirms the connection is working.

Tools

All tools are read-only except submit_feedback. Start any session by calling get_capabilities for up-to-date tool listings and suggested workflows.

Data Mapping

Documentation & Reference

Code Generation

Sample Data

Troubleshooting & Utility

Workflows

1. Map Source Data to Senzing Format

1. Call mapping_workflow with action='start' and your source file paths.
2. Walk through each step: Profile → Plan → Map → Codegen → QA.
3. Pass the state object from each response to the next call.
4. Run analyze_record to validate the output JSON and check feature distribution and coverage.

2. Generate SDK Integration Code

1. Call generate_scaffold with target language and workflow (e.g., language='python', workflow='full_pipeline').
2. Call find_examples to find real-world usage patterns in 27 indexed repos.
3. Use search_docs for API details and deployment guidance.

3. Troubleshoot Errors

1. Call explain_error_code with the error code from your logs.
2. Follow the resolution steps in the response.
3. Call search_docs for additional context on the error class.

4. Evaluate Senzing

1. Use search_docs to learn about architecture and pricing.
2. Call get_sample_data for real test data from CORD datasets.
3. Call generate_scaffold with workflow='full_pipeline' for an end-to-end example.

5. Migrate V3 to V4

1. Call get_sdk_reference with topic='migration' for all breaking changes.
2. Filter by module: topic='migration', filter='SzEngine'.
3. Use topic='flags' to understand the new flag system.

Troubleshooting

Connection Issues

If you cannot connect to the MCP server:

• Verify the endpoint URL: https://mcp.senzing.com/mcp
• Ensure your MCP client supports Streamable HTTP transport.
• Check that outbound HTTPS (port 443) is not blocked by your network.
• Try calling get_capabilities to verify the connection.

Empty or Unexpected Results

• search_docs returns no results: Try broader or different keywords. The server indexes Senzing-specific documentation, not general web content.
• find_examples returns no results: Try a more general query. Use language parameter to filter by programming language.
• explain_error_code not found: Verify the error code format. The tool accepts SENZ0005, 0005, or just 5.

Mapping Workflow Issues

• State errors: Always pass the complete state object from the previous response. The server is stateless — all workflow state lives in the client.
• Script download failures: Use download_resource as a fallback to get linter, analyzer, or entity spec files inline.

Data Privacy

Support

Email: support@senzing.com

Privacy Policy: mcp.senzing.com/privacy

Website: senzing.com