Client type header

The optional x-spotzee-client-type header identifies your client. The Main API uses mcp when applying the MCP rate-limit multiplier where per-key enforcement is available. The header does not bypass authentication, credit limits or per-IP limits.

x-spotzee-client-type: mcp

Check Rate limits before relying on extra request capacity. Omitting the header or sending an unrecognised value does not receive the MCP multiplier.

Recognised values

Use the value that describes your integration:

Value	Use for
`mcp`	MCP servers and agent runtimes that fan out parallel tool calls
`mobile`	Native iOS or Android apps using the official mobile SDKs
`sdk-js`	JavaScript SDK integrations (set explicitly on the generated client)
`sdk-android`	The official Android SDK (set automatically)
`sdk-ios`	The official iOS SDK (set automatically)
`cli`	Command-line tools (deploy scripts, one-off backfills, your own CLI)
`unknown`	Unspecified client; no MCP multiplier.

When to set it

MCP server
CLI tool
Custom integration (your own backend)
Official SDK

Set x-spotzee-client-type: mcp for MCP requests. Keep concurrency bounded and honour rate-limit responses.

Set x-spotzee-client-type: cli to identify command-line requests.

Leave the header off. Your traffic is treated as unknown and gets the standard rate-limit policy for your account. Use mcp only for MCP integrations.

The Android and iOS SDKs set their own values. For the generated JavaScript client, set x-spotzee-client-type: sdk-js in the client configuration.

Reference

Rate-limit policy and the MCP boost: see Rate limits
Authentication: see Authentication

Get started

Build

Configure

SDKs

Integrate

Reporting

Tools

API conventions

Recipes

Client type header

Recognised values

When to set it

Reference

​Recognised values

​When to set it

​Reference

Recognised values

When to set it

Reference