Loading ToolBench

Reading the current corpus…

interzoid-mcp-server MCP server · C · ToolBench

interzoid-mcp-server

github.com/interzoid/interzoid-mcp-server

MCP server that provides access to Interzoid's data matching, enrichment, and validation APIs. Supports 58 tools for company name matching, person name matching, address matching, email validation, phone validation, and other data quality operations. Supports x402 payment protocol for pay-per-call billing.

2026-07-28+STDIO9 tools

68/100

Definition Quality76

Protocol Readiness48

SupportabilityNot measured-

Spec posture

Inferred effective spec 2026-07-28+·current baseline 2026-07-28

Static source inference · medium confidence

Current-spec patterns detected

Summary

This MCP server exposes 9 data matching tools from the Interzoid API with consistent naming, clear descriptions, and properly structured schemas. Strengths: all tools follow verb_noun naming (interzoid_X_match/score), descriptions include pricing transparency ($0.01 via x402), and input schemas are well-formed with required/optional parameter distinctions. Weaknesses: descriptions lack context about when to choose between similar tools (e.g., when to use company_match_advanced vs standard company match), output schemas are not documented (responses are opaque JSON from the API), no error handling guidance for API failures, and no parameter constraints (enums, ranges, patterns). All 9 tools follow a consistent pattern with identical structure, reducing cognitive load for users but also indicating missed opportunities for tool-specific guidance.

Tools (9)

interzoid_address_and_fullname_matchread onlysource verified73/100

Generate a single combined AI-powered similarity key from a full name plus address. Records with the same combined key share both a similar address and a similar individual name. Useful for high-precision household/contact-level deduplication. Cost: $0.01 USDC via x402.

interzoid_address_match_advancedread onlysource verified77/100

Generate an advanced AI-powered similarity key for US street address matching. Handles unit numbers, directionals, and abbreviations. Cost: $0.01 USDC via x402.

interzoid_company_and_address_matchread onlysource verified73/100

Generate a combined AI-powered similarity key from a company name and address for location-specific company deduplication. Cost: $0.01 USDC via x402.

interzoid_company_match_advancedread onlysource verified77/100

Generate an advanced AI-powered similarity key for company/organization name matching. Names like 'IBM', 'International Business Machines', 'IBM Corp' produce the same key for deduplication and record linkage. Cost: $0.01 USDC via x402.

interzoid_fullname_matchread onlysource verified78/100

Generate an AI-powered similarity key for individual/person name matching. Handles variations like 'Bob Smith', 'Robert Smith', 'Smith, Robert J.' producing the same key. Cost: $0.01 USDC via x402.

interzoid_fullname_match_score

Issues (6)

HIGHresponse-shaper ↗

Output schemas not documented. Tools return raw API JSON responses without any documented structure for return fields, types, or pagination. LLMs cannot predict response shape for chaining or field extraction.

interzoid_company_match_advancedinterzoid_fullname_matchinterzoid_address_match_advancedinterzoid_global_address_matchinterzoid_product_matchinterzoid_org_match_scoreinterzoid_fullname_match_scoreinterzoid_address_and_fullname_matchinterzoid_company_and_address_match

HIGHrecovery-guide ↗

No error handling guidance. Callables return generic mcp.NewToolResultError() with raw API error messages or network errors. LLMs receive no classification (retryable? user-fixable? fatal?) and no recovery suggestions.

Recommendations

Document output schemas for each tool. Example for interzoid_company_match_advanced: 'Returns { "Code": 1-100 (match confidence), "SimilarityKey": string, "Credits": number_remaining }'. State which fields enable chaining.
Add error classification and recovery guidance in callables. Map API errors to actionable LLM guidance: 'API returned 401 (authentication failed). Ensure INTERZOID_API_KEY environment variable is set or Authorization header is valid. This is not retryable until credentials are corrected.' vs 'API returned 503 (service temporarily unavailable). This is retryable; try again in 30 seconds.'
Expand descriptions with selection criteria. E.g., 'Use interzoid_company_match_advanced for AI-powered fuzzy matching across name variations; use interzoid_org_match_score to compare exactly two known organization names with a 0-100 confidence score. Advanced variant handles 10x more edge cases but costs the same ($0.01).'
Add enum constraints for 'algorithm' parameters. Either document valid values (e.g. 'ai-deep', 'standard', 'legacy') or remove the parameter if only one algorithm exists.
For 'address_and_fullname_match' and 'company_and_address_match': either split into separate tools (interzoid_address_match + interzoid_fullname_match called separately) or clarify in the description why combining them is beneficial (e.g. 'Produces a single key incorporating both address and name, reducing false positives vs. matching address and name independently').
Add parameter-level guidance: 'zip (optional but recommended): Zip or postal code. Including this improves precision for US addresses from ~92% to ~98% match accuracy.'

Score history

Overall score trend

↑ 68 points across a rubric change (v1 → v2)

68/100

Scored	Grade	Overall	Spec posture	Rubric
2026-09-22	C	68	2026-07-28+	v2
2026-03-09	F	0	-	v1