Documentation

What are service tokens?

Service tokens are long-lived credentials for unattended AI agents and CI/CD pipelines that cannot complete an interactive OAuth browser flow. Instead of redirecting a user to sign in, you embed the token directly in your MCP client config as a standard Bearer header — no browser, no user interaction, no session expiry to manage.

Service tokens are separate from OAuth sessions. Calls made with a service token consume your monthly service-token quota and do not count against your daily OAuth allowance. This means you can run automated pipelines and still use the MCP server interactively in Claude or Cursor without affecting either quota.

Create a service token

1. 1

   Go to Dashboard → Service Tokens

   Open the Service Tokens page in your dashboard. You'll see your token allowance for your current plan (1 token on Agent Starter, 5 on Agent Pro).

2. 2

   Click Create token

   Give the token a descriptive name (e.g. kyb-pipeline-prod). The token value is shown once — copy it immediately and store it in your secrets manager.

3. 3

   Add to your MCP config

   Pass the token as a Bearer header in your MCP client config. Config examples for each supported tool are below.

Config examples

Add the following to your MCP client config, replacing st_live_your_token_here with your actual service token. Store the token in an environment variable or secrets manager rather than hardcoding it.

{
  "mcpServers": {
    "companylens": {
      "url": "https://mcp.companylens.io/mcp",
      "headers": {
        "Authorization": "Bearer st_live_your_token_here"
      }
    }
  }
}

Refer to your MCP client's documentation for the exact config file location and field names. For tool-specific setup instructions without service tokens, see the MCP setup guide.

Quotas and limits

Service tokens and OAuth sessions use independent quotas — calls from each never affect the other.

Service-token and OAuth call quotas both reset at the start of each billing period. Monitor usage in Dashboard → Overview.