Getting an API Key

HumanConnection uses API keys for authentication. Every request to the REST API and MCP server requires a valid key.

Get your key

1. Go to humanconnection.sh and sign up
2. Navigate to Settings > API Keys
3. Click Create API Key
4. Copy the key — it won’t be shown again

Authentication format

Pass your API key in the Authorization header as a Bearer token:

$
curl -X POST https://api.humanconnection.sh/api/v0/search_humans \
>
  -H "Authorization: Bearer hc_your_api_key_here" \
>
  -H "Content-Type: application/json" \
>
  -d '{"name": "Brian Chesky", "company_name": "Airbnb"}'

In the TypeScript toolkit

1
import { HumanConnection } from '@humanconnection/toolkit';
2
3
const hc = new HumanConnection({
4
  apiKey: process.env.HUMANCONNECTION_API_KEY
5
});

In MCP configuration

Add the key to your MCP server config:

1
{
2
  "mcpServers": {
3
    "humanconnection": {
4
      "type": "streamable-http",
5
      "url": "https://mcp.humanconnection.sh/mcp",
6
      "headers": {
7
        "Authorization": "Bearer hc_your_api_key_here"
8
      }
9
    }
10
  }
11
}

In the CLI

Set the environment variable:

$
export HUMANCONNECTION_API_KEY=hc_your_api_key_here
$
humanconnection humans search --name "Brian Chesky"

Key management

• Keys are scoped to your account and have access to all tools
• You can create multiple keys (e.g. one per environment)
• Revoke a key from Settings > API Keys at any time
• Never commit keys to source control — use environment variables

Rate limits

API keys are subject to rate limits. If you hit a limit, you’ll receive a 429 Too Many Requests response. Back off and retry after the Retry-After header value.