MCP

The Model Context Protocol (MCP) lets AI assistants call TheirStack tools directly — search jobs, find companies, explore tech stacks, and more — without leaving your chat.

Connect your AI client to the TheirStack MCP server at https://api.theirstack.com/mcp and start asking questions like:

"Find companies using Snowflake in Germany with 100+ employees"
"Show me senior engineering jobs at Series B startups"
"What technologies does Stripe use?"

Connect to TheirStack's MCP server

You can authenticate in two ways:

OAuth (default) — your client opens a browser the first time you connect and you log in with your TheirStack account. Works out of the box on Claude, Cursor, ChatGPT and every other MCP client below.
API key — paste an existing TheirStack API key in the Authorization header of your MCP client config. The key never expires unless you revoke it, so your client never needs to re-auth. Recommended if your client doesn't refresh OAuth tokens cleanly (most MCP clients still don't) or if you're connecting from an automation.

Each client tab below shows both flows. Create or grab an API key from app.theirstack.com → API Keys if you go that route — your auth choice is remembered across tabs.

Run this command in your terminal:

claude mcp add TheirStack --transport http https://api.theirstack.com/mcp

Claude Code will open a browser window to authenticate with your TheirStack account on first use.

claude mcp add TheirStack --transport http https://api.theirstack.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

No browser flow — the key is sent on every request.

Go to claude.ai and open Settings → Connectors
Click Add custom connector
Enter https://api.theirstack.com/mcp as the server URL and click Add
Complete the OAuth login with your TheirStack account

Open Settings → Connectors → Add custom connector
Enter https://api.theirstack.com/mcp as the server URL
Expand Advanced settings and add a custom header:
- Name: Authorization
- Value: Bearer <YOUR_API_KEY>
Save — no browser login required.

If your claude.ai workspace doesn't expose the custom-headers field, fall back to OAuth.

Add this to your .cursor/mcp.json file:

.cursor/mcp.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp"
        }
    }
}

Cursor will open a browser window to authenticate with your TheirStack account on first use.

.cursor/mcp.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Add this to .vscode/mcp.json in your workspace (requires GitHub Copilot Chat v1.102+):

.vscode/mcp.json

{
    "servers": {
        "theirstack": {
            "type": "http",
            "url": "https://api.theirstack.com/mcp"
        }
    }
}

Reload VS Code; Copilot Chat will prompt you to authenticate with TheirStack on first use.

.vscode/mcp.json

{
    "servers": {
        "theirstack": {
            "type": "http",
            "url": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Open ChatGPT → Settings → Connectors
Click Create to add a custom connector
Enter https://api.theirstack.com/mcp as the MCP server URL
Complete the OAuth login with your TheirStack account

Available on ChatGPT Plus, Pro, Business, and Enterprise.

Open Settings → Connectors → Create
Enter https://api.theirstack.com/mcp as the MCP server URL
Under Authentication, pick Custom header and add:
- Name: Authorization
- Value: Bearer <YOUR_API_KEY>
Save — the connector skips the OAuth login.

Add this to ~/.codeium/windsurf/mcp_config.json:

mcp_config.json

{
    "mcpServers": {
        "theirstack": {
            "serverUrl": "https://api.theirstack.com/mcp"
        }
    }
}

Restart Windsurf after saving. A browser window will open to authenticate with your TheirStack account on first use.

mcp_config.json

{
    "mcpServers": {
        "theirstack": {
            "serverUrl": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Open the MCP Servers panel in Cline and paste this config:

cline_mcp_settings.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp"
        }
    }
}

Cline will open a browser window to authenticate with your TheirStack account on first use.

cline_mcp_settings.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Add this to ~/.codex/config.toml:

config.toml

[mcp_servers.theirstack]
url = "https://api.theirstack.com/mcp"

Restart Codex; it will prompt you to authenticate with TheirStack on first use.

config.toml

[mcp_servers.theirstack]
url = "https://api.theirstack.com/mcp"

[mcp_servers.theirstack.headers]
Authorization = "Bearer <YOUR_API_KEY>"

Add this to ~/.gemini/settings.json:

settings.json

{
    "mcpServers": {
        "theirstack": {
            "httpUrl": "https://api.theirstack.com/mcp"
        }
    }
}

Restart the Gemini CLI; it will prompt you to authenticate with TheirStack on first use.

settings.json

{
    "mcpServers": {
        "theirstack": {
            "httpUrl": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Any MCP-compatible client can connect using:

Setting	Value
Server URL	`https://api.theirstack.com/mcp`
Transport	Streamable HTTP
Auth — OAuth	Your client handles the browser flow automatically
Auth — API key	Send `Authorization: Bearer <YOUR_API_KEY>` on every request

Refer to your client's documentation for how to configure MCP servers with HTTP transport and custom headers.

When the Authorization header is set the server validates the API key and skips OAuth entirely. Revoke the key at any time from the API Keys page to cut access.

Available tools

Search tools

Tool	Description	Example prompts
`search_jobs`	Search job postings with filters (title, company, tech, location, salary, etc.). API Reference	"Find senior Python developer jobs in Berlin paying over €80k" "Show me remote ML engineer roles posted in the last 7 days" "Find job postings mentioning React and TypeScript at Series B startups"
`search_companies`	Search companies by technographics, hiring signals, and firmographics. API Reference	"Find companies using Snowflake in Germany with 100+ employees" "Which startups in the US are hiring for AI/ML roles?" "Show me e-commerce companies in France that use Shopify"
`technographics`	Get the full technology stack for a specific company. API Reference	"What technologies does Stripe use?" "Show me Airbnb's tech stack" "Does Spotify use Kafka?"

Catalog tools

Tool	Description	Example prompts
`get_technologies`	Browse and search the technology catalog. API Reference	"List all available database technologies" "Is Terraform in the catalog?" "Search for technologies related to observability"
`get_industries`	List available industry categories. API Reference	"What industry categories are available?" "Show me all industries I can filter by"
`get_locations`	List available job locations. API Reference	"What locations can I search for jobs in?" "List available European job markets"
`list_categories`	List technology categories. API Reference	"What technology categories does TheirStack track?" "Show me all the tech stack categories"
`list_subcategories`	List technology subcategories. API Reference	"What subcategories exist under DevOps?" "Show me the subcategories for cloud infrastructure"

Account tools

Tool	Description	Example prompts
`get_credit_balance`	Check your API credit balance. API Reference	"How many credits do I have left?" "Check my TheirStack credit balance"
`get_credits_consumption`	View credit consumption details. API Reference	"How many credits have I used this month?" "Show my API usage breakdown"

Pricing

MCP requests consume API credits at the same rate as regular API calls. Learn more about our credit system here.

FAQs

Connect to TheirStack's MCP server

You can authenticate in two ways:

OAuth (default) — your client opens a browser the first time you connect and you log in with your TheirStack account. Works out of the box on Claude, Cursor, ChatGPT and every other MCP client below.

API key — paste an existing TheirStack API key in the Authorization header of your MCP client config. The key never expires unless you revoke it, so your client never needs to re-auth. Recommended if your client doesn't refresh OAuth tokens cleanly (most MCP clients still don't) or if you're connecting from an automation.

Each client tab below shows both flows. Create or grab an API key from app.theirstack.com → API Keys if you go that route — your auth choice is remembered across tabs.

Run this command in your terminal:

claude mcp add TheirStack --transport http https://api.theirstack.com/mcp

Claude Code will open a browser window to authenticate with your TheirStack account on first use.

claude mcp add TheirStack --transport http https://api.theirstack.com/mcp \
  --header "Authorization: Bearer <YOUR_API_KEY>"

No browser flow — the key is sent on every request.

Go to claude.ai and open Settings → Connectors
Click Add custom connector
Enter https://api.theirstack.com/mcp as the server URL and click Add
Complete the OAuth login with your TheirStack account

Open Settings → Connectors → Add custom connector
Enter https://api.theirstack.com/mcp as the server URL
Expand Advanced settings and add a custom header:
- Name: Authorization
- Value: Bearer <YOUR_API_KEY>
Save — no browser login required.

If your claude.ai workspace doesn't expose the custom-headers field, fall back to OAuth.

Add this to your .cursor/mcp.json file:

.cursor/mcp.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp"
        }
    }
}

Cursor will open a browser window to authenticate with your TheirStack account on first use.

.cursor/mcp.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Add this to .vscode/mcp.json in your workspace (requires GitHub Copilot Chat v1.102+):

.vscode/mcp.json

{
    "servers": {
        "theirstack": {
            "type": "http",
            "url": "https://api.theirstack.com/mcp"
        }
    }
}

Reload VS Code; Copilot Chat will prompt you to authenticate with TheirStack on first use.

.vscode/mcp.json

{
    "servers": {
        "theirstack": {
            "type": "http",
            "url": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Open ChatGPT → Settings → Connectors
Click Create to add a custom connector
Enter https://api.theirstack.com/mcp as the MCP server URL
Complete the OAuth login with your TheirStack account

Available on ChatGPT Plus, Pro, Business, and Enterprise.

Open Settings → Connectors → Create
Enter https://api.theirstack.com/mcp as the MCP server URL
Under Authentication, pick Custom header and add:
- Name: Authorization
- Value: Bearer <YOUR_API_KEY>
Save — the connector skips the OAuth login.

Add this to ~/.codeium/windsurf/mcp_config.json:

mcp_config.json

{
    "mcpServers": {
        "theirstack": {
            "serverUrl": "https://api.theirstack.com/mcp"
        }
    }
}

Restart Windsurf after saving. A browser window will open to authenticate with your TheirStack account on first use.

mcp_config.json

{
    "mcpServers": {
        "theirstack": {
            "serverUrl": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Open the MCP Servers panel in Cline and paste this config:

cline_mcp_settings.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp"
        }
    }
}

Cline will open a browser window to authenticate with your TheirStack account on first use.

cline_mcp_settings.json

{
    "mcpServers": {
        "theirstack": {
            "url": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Add this to ~/.codex/config.toml:

config.toml

[mcp_servers.theirstack]
url = "https://api.theirstack.com/mcp"

Restart Codex; it will prompt you to authenticate with TheirStack on first use.

config.toml

[mcp_servers.theirstack]
url = "https://api.theirstack.com/mcp"

[mcp_servers.theirstack.headers]
Authorization = "Bearer <YOUR_API_KEY>"

Add this to ~/.gemini/settings.json:

settings.json

{
    "mcpServers": {
        "theirstack": {
            "httpUrl": "https://api.theirstack.com/mcp"
        }
    }
}

Restart the Gemini CLI; it will prompt you to authenticate with TheirStack on first use.

settings.json

{
    "mcpServers": {
        "theirstack": {
            "httpUrl": "https://api.theirstack.com/mcp",
            "headers": {
                "Authorization": "Bearer <YOUR_API_KEY>"
            }
        }
    }
}

Any MCP-compatible client can connect using:

Setting	Value
Server URL	`https://api.theirstack.com/mcp`
Transport	Streamable HTTP
Auth — OAuth	Your client handles the browser flow automatically
Auth — API key	Send `Authorization: Bearer <YOUR_API_KEY>` on every request

Refer to your client's documentation for how to configure MCP servers with HTTP transport and custom headers.

When the Authorization header is set the server validates the API key and skips OAuth entirely. Revoke the key at any time from the API Keys page to cut access.

Available tools

Tool	Description	Example prompts
`search_jobs`	Search job postings with filters (title, company, tech, location, salary, etc.). API Reference	"Find senior Python developer jobs in Berlin paying over €80k" "Show me remote ML engineer roles posted in the last 7 days" "Find job postings mentioning React and TypeScript at Series B startups"
`search_companies`	Search companies by technographics, hiring signals, and firmographics. API Reference	"Find companies using Snowflake in Germany with 100+ employees" "Which startups in the US are hiring for AI/ML roles?" "Show me e-commerce companies in France that use Shopify"
`technographics`	Get the full technology stack for a specific company. API Reference	"What technologies does Stripe use?" "Show me Airbnb's tech stack" "Does Spotify use Kafka?"

Tool	Description	Example prompts
`get_technologies`	Browse and search the technology catalog. API Reference	"List all available database technologies" "Is Terraform in the catalog?" "Search for technologies related to observability"
`get_industries`	List available industry categories. API Reference	"What industry categories are available?" "Show me all industries I can filter by"
`get_locations`	List available job locations. API Reference	"What locations can I search for jobs in?" "List available European job markets"
`list_categories`	List technology categories. API Reference	"What technology categories does TheirStack track?" "Show me all the tech stack categories"
`list_subcategories`	List technology subcategories. API Reference	"What subcategories exist under DevOps?" "Show me the subcategories for cloud infrastructure"

Tool	Description	Example prompts
`get_credit_balance`	Check your API credit balance. API Reference	"How many credits do I have left?" "Check my TheirStack credit balance"
`get_credits_consumption`	View credit consumption details. API Reference	"How many credits have I used this month?" "Show my API usage breakdown"

Connect to TheirStack's MCP server

Available tools

Search tools

Catalog tools

Account tools

Pricing

FAQs

On this page

MCP

Connect to TheirStack's MCP server

Available tools

Search tools

Catalog tools

Account tools

Pricing

FAQs

On this page

MCP

What is the Model Context Protocol?

Which AI clients are supported?

How are credits consumed?

Do I need to install anything?

How does authentication work?

Why does the MCP disconnect / ask me to re-authenticate every day?

On this page

MCP

What is the Model Context Protocol?

Which AI clients are supported?

How are credits consumed?

Do I need to install anything?

How does authentication work?

Why does the MCP disconnect / ask me to re-authenticate every day?

On this page