# cinch-connectivity-mcp v1.21.0
# Cinch Connectivity Solutions — MCP Product Data Server
# Protocol: MCP (Model Context Protocol) 2025-11-25

## What This Server Does
Provides structured access to Cinch's electronic connector catalog:
parts lookup, parametric search, category browsing, cross-references,
compatibility data, document search, and data export.

## How To Use (IMPORTANT)
Transport: Streamable HTTP (JSON-RPC 2.0)
Endpoint: POST https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/mcp
Session: Stateless — NO initialization handshake required
Authentication: None required (public access)

Required headers:
  Content-Type: application/json
  Accept: application/json, text/event-stream

## Quick Start Examples

### List all available tools:
curl -X POST https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/list","id":1,"params":{}}'

### Call a tool (keyword search):
curl -X POST https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":1,"params":{"name":"cinch_search_keyword","arguments":{"keyword":"circular connector"}}}'

## Common Mistakes (avoid these)
- Using GET instead of POST for /mcp (GET is for SSE streams only)
- Using wrong method names: "list_tools", "mcp/discover", "call_tool", "get_tools"
  Correct methods: "tools/list", "tools/call", "initialize" (optional)
- Sending "mcp/initialize" — no initialization is needed, just call tools directly
- Missing the Accept header — must include "application/json, text/event-stream"

## Available Tools (18)
  - cinch_get_part: Quick Part Lookup
  - cinch_get_part_details: Complete Part Details
  - cinch_search_parts: Search Parts by Category
  - cinch_get_categories: Browse Categories
  - cinch_get_category_filters: Category Filter Options
  - cinch_get_related_parts: Related Parts
  - cinch_search_documents: Search Documents
  - cinch_search_keyword: Keyword Search
  - cinch_export_category: Export Category to Excel
  - cinch_get_new_products: New Products
  - cinch_product_viewer: Interactive Product Viewer
  - cinch_get_extended_relationships: Extended Relationships
  - cinch_competitor_xref: Competitor Cross-Reference
  - cinch_compatibility_viewer: Compatibility Viewer
  - cinch_compare_parts: Compare Parts
  - cinch_discover_by_attributes: Discover by Attributes
  - cinch_export_by_asset: Export by Asset Type
  - cinch_get_part_image: Product Image

## Discovery Endpoints
- GET https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/ — Server info + quick start (JSON)
- GET https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/.well-known/mcp.json — Machine-readable discovery (JSON)
- GET https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/llms.txt — This file
- GET https://app-cinch-mcp-ajgxhgezdwcxejhy.westus-01.azurewebsites.net/health — Health check + tool list