Zintlr MCP Server

Remote MCP (Model Context Protocol) server for LLM integration with Zintlr sales intelligence platform.

Overview

This server allows LLM users to connect to Zintlr directly from their MCP client's Settings → Connectors interface by simply pasting the server URL.

LLM Client → MCP Server (mcp.zintlr.com) → Zintlr APIs (api.zintlr.com)

Features

• Remote MCP Protocol: Works with any MCP-compatible LLM client
• OAuth Passthrough: Redirects to Zintlr login, stores existing JWT tokens
• Direct API Access: Bypasses auth.zintlr.com proxy, calls api.zintlr.com directly
• 13 Tools: Search prospects, get profiles, unlock contacts, and more

Quick Start

1. Configure Environment

cp .env.example .env

Edit .env with your secrets:

• CIPHER_SECRET: Same as process.env.CIPHER in Next.js proxy
• CAPTCHA_TOKEN: Same as CAPTCHA_TOKEN in Next.js proxy
• MCP_SERVER_URL: Public URL of this server

2. Run with Docker

docker-compose up -d

3. Run Locally (Development)

pip install -r requirements.txt
uvicorn app.main:app --reload --port 8000

User Setup

1. Open your MCP-compatible LLM client (e.g., Claude, etc.)
2. Go to Settings → Connectors
3. Click "Add custom connector"
4. Enter URL: https://mcp.zintlr.com (your deployed URL)
5. Complete OAuth flow (redirects to Zintlr login)
6. Done! Tools are now available in your LLM

Available Tools

Architecture

┌─────────────────┐     ┌─────────────────┐     ┌─────────────────┐
│   LLM Client    │────▶│   MCP Server    │────▶│  Zintlr API     │
│  (User's app)   │     │ (This service)  │     │ api.zintlr.com  │
└─────────────────┘     └─────────────────┘     └─────────────────┘
        │                       │
        │ JSON-RPC              │ HTTP + Decrypted JWT
        │ + Session ID          │ + Headers (Auth, visitor-id)
        │                       │

Authentication Flow

1. User adds connector URL in LLM client
2. LLM client requests OAuth metadata from /.well-known/oauth-authorization-server
3. User redirected to /oauth/authorize → Zintlr login
4. After login, Zintlr redirects to /oauth/callback with JWT tokens
5. MCP server stores tokens in Redis, returns session ID to LLM client
6. LLM client uses session ID as Bearer token for MCP requests
7. MCP server decrypts tokens, calls Zintlr API directly

Proxy Bypass

This server replicates the Next.js proxy logic (auth.zintlr.com):

• Decrypts JWT tokens using verify_and_decrypt_jwt(token, CIPHER)
• Sets Authorization header with decrypted access_token
• Sets visitor-id and client-ip-address headers
• Adds decrypted key to request body
• Calls api.zintlr.com directly

API Endpoints

Environment Variables

Testing

Test MCP Endpoint

# Initialize
curl -X POST http://localhost:8000/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"test","version":"1.0"}}}'

# List tools
curl -X POST http://localhost:8000/ \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Test Health

curl http://localhost:8000/health

Deployment

Docker

docker build -t zintlr-mcp-server .
docker run -p 8000:8000 --env-file .env zintlr-mcp-server

Docker Compose

docker-compose up -d

Production Checklist

• Set DEBUG=false
• Configure proper MCP_SERVER_URL with HTTPS
• Set secure CIPHER_SECRET and CAPTCHA_TOKEN
• Configure Redis persistence
• Set up reverse proxy (nginx) with SSL
• Configure DNS for mcp.zintlr.com

License

Proprietary - Zintlr