AI Tool Integrations

Isartor is an OpenAI-compatible and Anthropic-compatible gateway that deflects repeated or simple prompts at Layer 1 (cache) and Layer 2 (local SLM) before they reach the cloud. Clients integrate by overriding their base URL to point at Isartor or by registering Isartor as an MCP server — no proxy, no MITM, no CA certificates.

Endpoints

Isartor's server defaults to: http://localhost:8080.

Authenticated chat endpoints:

Authentication

Isartor can enforce a gateway key on authenticated routes when Layer 0 auth is enabled.

Supported headers:

• X-API-Key: <gateway_api_key>
• Authorization: Bearer <gateway_api_key> (useful for OpenAI/Anthropic-compatible clients)

By default, gateway_api_key is empty and auth is disabled (local-first). To enable gateway authentication, set ISARTOR__GATEWAY_API_KEY to a secret value. In production, always set a strong key.

Observability headers

All endpoints in the Deflection Stack include:

• X-Isartor-Layer: l1a | l1b | l2 | l3 | l0
• X-Isartor-Deflected: true if resolved locally (no cloud call)

Example: OpenAI-compatible request

curl -sS http://localhost:8080/v1/chat/completions \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "gpt-4o-mini",
    "messages": [
      {"role": "user", "content": "2 + 2?"}
    ]
  }'

If gateway auth is enabled, also add:

-H 'Authorization: Bearer your-secret-key'

Many OpenAI-compatible SDKs and coding agents also call:

curl -sS http://localhost:8080/v1/models

OpenAI-compatible agent features supported by Isartor:

• GET /v1/models for model discovery
• stream: true on /v1/chat/completions with OpenAI-style SSE and data: [DONE]
• tools, tool_choice, functions, and function_call passthrough
• tool_calls preserved in provider responses
• tool-aware exact cache keys, with semantic cache skipped for tool-use flows

Example: Anthropic-compatible request

curl -sS http://localhost:8080/v1/messages \
  -H 'Content-Type: application/json' \
  -d '{
    "model": "claude-sonnet-4-6",
    "system": "Be concise.",
    "max_tokens": 100,
    "messages": [
      {
        "role": "user",
        "content": [{"type": "text", "text": "What is the capital of France?"}]
      }
    ]
  }'

If gateway auth is enabled, also add:

-H 'X-API-Key: your-secret-key'

Supported tools at a glance

Add --gateway-api-key <key> to any connect command only if you have explicitly enabled gateway auth.

Connection status

# Check all connected clients
isartor connect status

Global troubleshooting

For tool-specific troubleshooting, see each integration page above.