Authentication

Learn how to generate and manage API keys for the Particl MCP server.

API key overview

All requests to the Particl MCP server are authenticated using API keys. Each key is scoped to your account and provides access to the data available on your plan.

API keys are passed as a Bearer token in the Authorization header when connecting to the MCP server. Your AI client sends this automatically based on its configuration.

Generating a key

  1. 1.Sign in to app.particl.com
  2. 2.Go to Settings → MCP
  3. 3.Toggle MCP on to generate your API key
  4. 4.Copy the generated key

Keep your key secure

API keys grant access to your Particl data. Never commit them to version control or share them publicly.

Using your key

Pass your key as a Bearer token in the Authorization header in your MCP client configuration:

Example configuration
{
  "mcpServers": {
    "particl": {
      "type": "http",
      "url": "https://particl-mcp.onrender.com/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_PARTICL_API_KEY"
      }
    }
  }
}

No local installation is required — the Particl MCP server runs as a hosted service. Your AI client connects to it over HTTP.

Key management

ActionHow
Enable MCPSettings → MCP → Toggle on
Regenerate keyToggle MCP off and back on to generate a new key
Disable MCPSettings → MCP → Toggle off (revokes the key immediately)

Rate limits

The Particl MCP server allows up to 100 requests per 60 seconds per API token. If you exceed this limit, requests will return an error until the window resets.

Credits

Most MCP tools consume export credits when returning data. Credits are shared with CSV exports in the Particl dashboard.

CategoryToolsCost
Freesearch_companies, get_credit_balanceNone
Per rowsearch_market_products, get_company_products, get_market_top_products, get_market_top_companies1 credit per row returned
Per callget_company_details, get_market_pricing_analysis1 credit per call

Use get_credit_balance to check your remaining credits at any time.