Partglyph MCP Gateway

Partglyph MCP Gateway

The Partglyph MCP gateway lets customer MCP clients use Partglyph product matching from tools such as Claude Code, Codex, and other MCP-capable clients.

The gateway is designed for controlled beta use. It exposes deterministic tools and resources. It does not run a Partglyph-side LLM, OCR system, document reader, image reader, web extractor, or direct customer matcher path.

Endpoint

Use the hosted beta endpoint:

https://app.partglyph.com/api-mcp/mcp

Configure your MCP client to use this endpoint with a Partglyph user API key as a bearer token.

Copy-Paste MCP Configuration

For Codex, add this block to ~/.codex/config.toml and replace PASTE_YOUR_PARTGLYPH_API_KEY_HERE with the key created in Partglyph:

[mcp_servers.partglyph]

url = "https://app.partglyph.com/api-mcp/mcp"


[mcp_servers.partglyph.http_headers]

Authorization = "Bearer PASTE_YOUR_PARTGLYPH_API_KEY_HERE"

For other MCP clients that ask for connection values, use:

Name: partglyph

Transport: streamable HTTP

URL: https://app.partglyph.com/api-mcp/mcp

Authorization header: Bearer PASTE_YOUR_PARTGLYPH_API_KEY_HERE

Do not include quotes around the API key unless your client specifically asks for quoted values.

API Key

Create the key in the Partglyph app:

https://app.partglyph.com/settings/api-keys

Use the Partglyph MCP Access preset.

The preset is intended for normal MCP matching and includes:

Scope	Purpose
match:run	Run governed paid matches through user management.
history:read_own	Read the user’s own match history and result detail.
credits:view_balance	Let the MCP flow verify available credits before a paid match.

Do not share the generated API key. API keys are shown only at creation time.

What Partglyph MCP Does

Partglyph MCP receives structured fields and performs deterministic gateway work:

• lists supported product families;
• returns the product selection catalog;
• returns product contracts, prepared-input schemas, and match-result schema references;
• returns product-specific input preparation guides;
• validates prepared matcher input without charging credits;
• builds the user-management match-run request;
• runs paid governed matches through user management;
• records the run in user history;
• records the source as MCP for admin tracking;
• returns compact result output;
• exposes history and result detail tools;
• exposes product-specific result display guidance;
• exposes deterministic instruction resources for the customer LLM.

Result Controls

MCP match tools include non-drop-in candidates by default so users can see the engineering decision space.

Option	Default	Use
include_non_drop_in	true	Set to false only when the user asks for drop-in results only.
limit	optional	Set when the user asks for a smaller or larger result list.

Result presentation should preserve matcher status, result class, warnings, missing information, and product-specific flags. The customer LLM may format the response as tables and summaries, but must not invent candidates, hide warnings, or strengthen a result beyond the evidence.

Common Tool Flow

Use this flow for a normal match:

1. get_product_selection_catalog
2. get_product_contract
3. get_input_preparation_guide
4. validate_prepared_input
5. build_match_request
6. run_match
7. get_result_display_guide
8. get_match_history or get_match_result_detail when the user asks for previous runs or deeper detail

Ball Valve detail may also use get_ball_valve_identity_rows when a result exposes lazy identity rows.

History And Admin Tracking

A successful MCP match is treated as a normal governed Partglyph run:

• credits are charged through user management;
• the user’s match appears in history;
• result detail is available through user-management history tools;
• admin tracking can filter runs with source mode mcp;
• linked analytics records source MCP.

Not Part Of The MCP Gateway

The MCP gateway does not:

• run Partglyph-side LLM calls;
• spend Partglyph LLM tokens;
• perform server-side OCR;
• read documents, images, links, or web pages for the customer;
• bypass user-management auth, credits, history, or telemetry;
• call the matcher directly for customer execution;
• guarantee that every MCP client will automatically route every part-search request to Partglyph.

The customer’s MCP client can still use its own LLM and tools to read source material, ask clarifying questions, and format final responses.