Parasail (gateway)

1
{
2
  "mcpServers": {
3
    "respan-docs": {
4
      "url": "https://mcp.respan.ai/mcp/docs"
5
    }
6
  }
7
}

Use Respan Gateway to call Parasail models while keeping unified observability (logs, cost, latency, and reliability metrics) in Respan.

Prerequisites

• A Respan API key
• Parasail API key (BYOK)

Supported SDKs / integrations

Configuration

There are 2 ways to add your Parasail credentials to your requests:

Via UI (Global)

1

Navigate to Providers

Go to the Providers page. This page allows you to manage credentials for supported model providers.

2

Add your Parasail credentials

Select Parasail and add the required credential fields.

• parasail.api_key — your Parasail API key

3

Configure Load Balancing (Optional)

Add multiple Parasail credential sets for redundancy. Use the Load balancing weight field to control traffic distribution.

Via code (Per-Request)

You can pass credentials dynamically in the request body. This is useful if you need to use your users’ own API keys (BYOK).

Add the customer_credentials parameter to your Gateway request:

1
{
2
  "customer_credentials": {
3
    "parasail": {
4
      "api_key": "YOUR_PARASAIL_API_KEY"
5
    }
6
  }
7
}

Override credentials for a particular model (Optional)

Use credential_override when one request or model should use different credentials than the default provider key.

1
{
2
  "customer_credentials": {
3
    "parasail": {
4
      "api_key": "YOUR_PARASAIL_API_KEY"
5
    }
6
  },
7
  "credential_override": {
8
    "parasail/model-name": {
9
      "api_key": "ANOTHER_PARASAIL_API_KEY"
10
    }
11
  }
12
}

Supported models

Find the complete and current list of Parasail model IDs on the Respan Models page. Use the exact model ID shown there in your gateway requests.

Log Parasail requests

If you are not using the Gateway to proxy requests, you can still log your Parasail requests to Respan asynchronously. This lets you track cost, latency, and performance metrics for external calls.

1
import requests
2
3
url = "https://api.respan.ai/api/request-logs/create/"
4
payload = {
5
  "model": "parasail/model-name",
6
  "prompt_messages": [
7
    {
8
      "role": "user",
9
      "content": "Hello, how are you?"
10
    }
11
  ],
12
  "completion_message": {
13
    "role": "assistant",
14
    "content": "Hello from Parasail through Respan."
15
  },
16
  "cost": 0.001,
17
  "generation_time": 1.2,
18
  "customer_params": {
19
    "customer_identifier": "user_123"
20
  }
21
}
22
headers = {
23
    "Authorization": "Bearer YOUR_RESPAN_API_KEY",
24
    "Content-Type": "application/json",
25
}
26
27
response = requests.post(url, headers=headers, json=payload)