SDKs

Official client libraries and integrations for the Zihin platform.

Available Packages

Package	Status	Install
@zihin/mcp-server	Published	npx @zihin/mcp-server
Python SDK	Planned	pip install zihin
Node.js SDK	Planned	npm install @zihin/sdk

MCP Server (stdio proxy)

The @zihin/mcp-server package is a stdio-to-HTTP proxy that connects MCP clients (Claude Desktop, Cursor, Claude Code, Codex, Windsurf) to the Zihin MCP Server.

ZIHIN_API_KEY=YOUR_API_KEY npx @zihin/mcp-server

See the MCP Server page for setup instructions for each client.

REST API

For direct HTTP integration, use the REST API:

curl -X POST https://llm.zihin.ai/api/v3/llm/public/call \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"query": "Hello", "model": "auto"}'

See the API Overview for conventions and the full API Reference.

MCP over HTTP

For server-to-server or automation tools (N8N, Make, Zapier, custom scripts), connect directly to the MCP HTTP endpoint without the npm package:

curl -X POST "https://llm.zihin.ai/mcp" \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"my-app","version":"1.0"}}}'

See MCP Server - HTTP Transport for details.

N8N Integration

For no-code automation, use the Zihin N8N Nodes to connect Zihin to N8N workflows.