MCP Tokens

List MCP Tokens

Retrieve all MCP tokens associated with an account.

Path Parameters

string

required

Account identifier (format: acc_ followed by 27 alphanumeric characters)

Headers

string

required

Bearer token for authentication

Response

boolean

Indicates if there are more records to paginate through

array

Show MCP Token Objects

string

Unique MCP token identifier (format: mcp_ prefix)

string

Account identifier this token belongs to

string

Environment this token is scoped to

array

Array of bucket SIDs this token can access. Empty array means all buckets in the environment.

string

Name of the MCP token

string

Masked token value (full value only shown on creation)

boolean

Whether this token has been revoked

string

ISO 8601 timestamp of last token usage (nullable)

string

ISO 8601 timestamp of token creation

curl -X GET "https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens" \
  -H "Authorization: Bearer your-jwt-token"

const response = await fetch('https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens', {
  headers: {
    'Authorization': 'Bearer your-jwt-token'
  }
});

const tokens = await response.json();
console.log(tokens);

{
  "hasMore": false,
  "records": [
    {
      "sid": "mcp_abc123def456ghi789jkl012",
      "accountSid": "acc_abc123def456ghi789jkl012",
      "environmentSid": "prod01",
      "bucketSids": [],
      "name": "Claude Desktop - Production",
      "token": "mcp_2abc1*******ef789",
      "isRevoked": false,
      "lastUsedAt": "2025-03-15T14:30:00.000Z",
      "createdAt": "2025-03-15T10:30:00.000Z",
      "updatedAt": "2025-03-15T10:30:00.000Z",
      "revokedAt": null
    }
  ]
}

Create MCP Token

Create a new MCP token for AI assistant access. MCP tokens are read-only and scoped to a specific environment and set of buckets.

Path Parameters

string

required

Account identifier

Headers

string

required

Bearer token for authentication

Request Body

string

required

A descriptive name for the MCP token (e.g. “Claude Desktop - Production”)

string

required

The environment SID this token should be scoped to

array

Array of bucket SIDs to restrict access to. Leave empty or omit to grant access to all buckets in the environment.

Response

Returns the created MCP token with the full token value (only shown once).

The token value is only returned once during creation. Store it securely as it cannot be retrieved again.

curl -X POST "https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens" \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Claude Desktop - Production",
    "environmentSid": "prod01",
    "bucketSids": []
  }'

const response = await fetch('https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens', {
  method: 'POST',
  headers: {
    'Authorization': 'Bearer your-jwt-token',
    'Content-Type': 'application/json'
  },
  body: JSON.stringify({
    name: 'Claude Desktop - Production',
    environmentSid: 'prod01',
    bucketSids: []
  })
});

const token = await response.json();
console.log(token);
// Store token.token securely!

{
  "sid": "mcp_abc123def456ghi789jkl012",
  "accountSid": "acc_abc123def456ghi789jkl012",
  "environmentSid": "prod01",
  "bucketSids": [],
  "name": "Claude Desktop - Production",
  "token": "mcp_2abc1d3e4f5g6h7i8j9k0l1m2n3o4p5q6r7s8t9u0v1w2x3y4z",
  "isRevoked": false,
  "lastUsedAt": null,
  "createdAt": "2025-03-15T10:30:00.000Z",
  "updatedAt": "2025-03-15T10:30:00.000Z",
  "revokedAt": null
}

Update MCP Token

Update an existing MCP token’s name or bucket scope.

Path Parameters

string

required

Account identifier

string

required

MCP token identifier

Headers

string

required

Bearer token for authentication

Request Body

string

Updated name for the token

array

Updated array of bucket SIDs (empty = all buckets in environment)

curl -X PUT "https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens/mcp_abc123def456ghi789jkl012" \
  -H "Authorization: Bearer your-jwt-token" \
  -H "Content-Type: application/json" \
  -d '{
    "name": "Claude Desktop - Staging",
    "bucketSids": ["abc1234", "def5678"]
  }'

{
  "sid": "mcp_abc123def456ghi789jkl012",
  "accountSid": "acc_abc123def456ghi789jkl012",
  "environmentSid": "prod01",
  "bucketSids": ["abc1234", "def5678"],
  "name": "Claude Desktop - Staging",
  "token": "mcp_2abc1*******ef789",
  "isRevoked": false,
  "lastUsedAt": "2025-03-15T14:30:00.000Z",
  "createdAt": "2025-03-15T10:30:00.000Z",
  "updatedAt": "2025-03-15T15:00:00.000Z",
  "revokedAt": null
}

Revoke MCP Token

Revoke an MCP token, immediately terminating access for any AI assistants using it.

This action is immediate. Any AI assistants using this token will lose access instantly.

Path Parameters

string

required

Account identifier

string

required

MCP token identifier

Headers

string

required

Bearer token for authentication

curl -X DELETE "https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens/mcp_abc123def456ghi789jkl012" \
  -H "Authorization: Bearer your-jwt-token"

const response = await fetch('https://api.apitraffic.io/v1/accounts/acc_abc123def456ghi789jkl012/mcpTokens/mcp_abc123def456ghi789jkl012', {
  method: 'DELETE',
  headers: {
    'Authorization': 'Bearer your-jwt-token'
  }
});

const result = await response.json();
console.log(result);

{
  "sid": "mcp_abc123def456ghi789jkl012",
  "deleted": true
}

API Documentation

Core Resources

Data Management

Automation

List MCP Tokens

Path Parameters

Headers

Response

Create MCP Token

Path Parameters

Headers

Request Body

Response

Update MCP Token

Path Parameters

Headers

Request Body

Revoke MCP Token

Path Parameters

Headers

​List MCP Tokens

​Path Parameters

​Headers

​Response

​Create MCP Token

​Path Parameters

​Headers

​Request Body

​Response

​Update MCP Token

​Path Parameters

​Headers

​Request Body

​Revoke MCP Token

​Path Parameters

​Headers

List MCP Tokens

Path Parameters

Headers

Response

Create MCP Token

Path Parameters

Headers

Request Body

Response

Update MCP Token

Path Parameters

Headers

Request Body

Revoke MCP Token

Path Parameters

Headers