Claude MCP Integration

QANATIX registers as a native MCP tool. Claude calls qanatix_search() directly — no prompt engineering, no API wrapper code.

Authentication

QANATIX MCP accepts your API key via two headers:

Header	Format	When to use
`Authorization`	`Bearer sk_live_...`	Standard — works with Claude Desktop, curl, most MCP clients
`X-API-Key`	`sk_live_...`	Fallback — use if your client's HTTP proxy strips Authorization headers

Both headers are equivalent. Use whichever your client supports.

Claude Code

One command:

claude mcp add --transport http \
  --header "Authorization: Bearer sk_live_abc123..." \
  qanatix https://api.qanatix.com/mcp/

If the Authorization header doesn't work (some MCP proxy configurations strip it), use X-API-Key instead:

claude mcp add --transport http \
  --header "X-API-Key: sk_live_abc123..." \
  qanatix https://api.qanatix.com/mcp/

Or add it to your project's .mcp.json:

{
  "mcpServers": {
    "qanatix": {
      "type": "http",
      "url": "https://api.qanatix.com/mcp/",
      "headers": {
        "Authorization": "Bearer ${QANATIX_API_KEY}"
      }
    }
  }
}

After adding, run /mcp in Claude Code to reconnect. You should see qanatix with 5 tools available.

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "qanatix": {
      "url": "https://api.qanatix.com/mcp/",
      "headers": {
        "Authorization": "Bearer sk_live_abc123..."
      }
    }
  }
}

Restart Claude Desktop. QANATIX appears as a connected tool.

Usage

Just ask Claude naturally:

Find ISO 9001 certified stainless M8 suppliers in the EU

Claude recognizes this as a data query, calls qanatix_search(), and returns:

Found 3 verified results from your manufacturing database:

1. Muller Befestigungen GmbH — Frankfurt, DE
   EUR 0.08/unit · MOQ 500 · 5d lead · IN STOCK

2. Schafer Schrauben AG — Stuttgart, DE
   EUR 0.07/unit · MOQ 1000 · 7d lead · IN STOCK

Score: 0.87 · 74 tokens · 138ms

Available tools

Once connected, Claude has access to 5 tools:

`qanatix_collections`

Discover available data, record counts, and filterable fields with types and sample values. Call this first.

`qanatix_search`

Unified search — works with a query, filters, or both. Supports sort, offset pagination, and JSON output:

{
  "collection": "manufacturing",
  "query": "stainless M8 bolt",
  "filters": {
    "in_stock": "True",
    "price_max": "0.20",
    "manufacturer": "SKF,ABB"
  },
  "sort": "-price_usd",
  "limit": 10,
  "offset": 0,
  "format": "json"
}

Filter syntax: field=val (exact), field=val1,val2 (multi-value), field_min/field_max (range), field_gt/field_lt (comparison), field_in=val1,val2 (explicit IN).

`qanatix_aggregate`

Count, group, and compute stats — for questions like "how many products by brand?" or "what's the price range?":

{
  "collection": "manufacturing",
  "group_by": "manufacturer",
  "stats": "price_usd,weight_kg"
}

`qanatix_list`

Browse/paginate records with cursor pagination:

{
  "collection": "finance",
  "record_type": "etf",
  "limit": 20
}

The response includes a cursor for the next page. For most use cases, qanatix_search with no query provides the same functionality with more options (sort, filters, offset).

`qanatix_lookup`

Get full details for a specific record by UUID:

{
  "record_id": "550e8400-e29b-41d4-a716-446655440000",
  "format": "json"
}

Self-hosted MCP

If you're running QANATIX on your own infra, point the MCP URL to your instance:

{
  "mcpServers": {
    "qanatix": {
      "url": "http://localhost:8000/mcp/",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Same tools, same protocol. Data never leaves your network.

Troubleshooting

"Authentication required" error

Your API key isn't reaching the server. Try:

Check your key — make sure it starts with sk_live_ or sk_test_ and is valid

Switch header — some HTTP proxies strip Authorization. Use X-API-Key instead:

claude mcp remove qanatix
claude mcp add -t http -H "X-API-Key: sk_live_..." qanatix https://api.qanatix.com/mcp/

Reconnect — run /mcp in Claude Code to refresh the connection

Test with curl — verify your key works:

curl -X POST https://api.qanatix.com/mcp/ \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -H "Authorization: Bearer sk_live_..." \
  -d '{"jsonrpc":"2.0","method":"tools/call","id":1,"params":{"name":"qanatix_collections","arguments":{}}}'

Queries under 3 characters may return empty results. The full-text search needs enough text to produce meaningful matches. Try more descriptive queries like "stainless steel valve" instead of "valve".

Claude (MCP)