Skip to main content
API keys authenticate requests to both the UseAgents MCP server and the REST API. They are organization-scoped and managed through WorkOS.

Create an API key

  1. Go to useagents.site/dashboard.
  2. Create or select an organization.
  3. Open SettingsAPI Keys.
  4. Click Create API Key and follow the prompts.
  5. Copy the key immediately. You will not be able to view it again later.
Store API keys securely. If you lose a key, create a new one. Never commit keys to version control.

Use an API key with the MCP server

Pass the key in the x-api-key header when connecting the UseAgents MCP server:
{
  "mcpServers": {
    "useagents": {
      "url": "https://mcp.useagents.site/mcp",
      "headers": {
        "x-api-key": "USEAGENTS_API_KEY"
      }
    }
  }
}
See Connecting the MCP Server for full setup instructions.

Use an API key with the REST API

For direct API calls, include the key in the Authorization header as a Bearer token:
Authorization: Bearer YOUR_API_KEY
Example:
curl -H "Authorization: Bearer YOUR_API_KEY" "https://api.useagents.site/tools/search?q=typescript%20sdk"

Organization scope

API keys are tied to an organization. If you belong to multiple organizations, create or use the key that belongs to the organization you want the integration to act on behalf of.

Security

  • Rotate keys if you suspect exposure.
  • Use separate keys for different environments or integrations when appropriate.
  • Avoid sharing the same key across unrelated systems.

Next steps