MCP
TheirStack TheirStack Logo
DocumentationAPI ReferenceWebhooksDatasetsMCP

MCP

Search job postings, company technographics, and hiring data directly from Claude, Cursor, or any MCP client. TheirStack's MCP server gives AI assistants access to millions of jobs and tech stack data.

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

Before connecting, grab your API key from the API settings page.

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

.cursor/mcp.json
{
    "mcpServers": {
        "theirstack": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://api.theirstack.com/mcp",
                "--header",
                "Authorization:Bearer YOUR_API_KEY"
            ]
        }
    }
}

Replace YOUR_API_KEY with your actual API key.

Run this command in your terminal:

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

Replace YOUR_API_KEY with your actual API key.

Add this to your claude_desktop_config.json (how to find it):

claude_desktop_config.json
{
    "mcpServers": {
        "theirstack": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://api.theirstack.com/mcp",
                "--header",
                "Authorization:Bearer YOUR_API_KEY"
            ]
        }
    }
}

Replace YOUR_API_KEY with your actual API key.

Add this to your Windsurf MCP configuration:

mcp_config.json
{
    "mcpServers": {
        "theirstack": {
            "command": "npx",
            "args": [
                "mcp-remote",
                "https://api.theirstack.com/mcp",
                "--header",
                "Authorization:Bearer YOUR_API_KEY"
            ]
        }
    }
}

Replace YOUR_API_KEY with your actual API key.

Any MCP-compatible client can connect using:

SettingValue
Server URLhttps://api.theirstack.com/mcp
TransportHTTP
Auth headerAuthorization: Bearer YOUR_API_KEY

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

Available tools

Search tools

ToolDescriptionExample prompts
search_jobsSearch 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_companiesSearch 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"
technographicsGet 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

ToolDescriptionExample prompts
get_technologiesBrowse and search the technology catalog. API Reference
  • "List all available database technologies"
  • "Is Terraform in the catalog?"
  • "Search for technologies related to observability"
get_industriesList available industry categories. API Reference
  • "What industry categories are available?"
  • "Show me all industries I can filter by"
get_locationsList available job locations. API Reference
  • "What locations can I search for jobs in?"
  • "List available European job markets"
list_categoriesList technology categories. API Reference
  • "What technology categories does TheirStack track?"
  • "Show me all the tech stack categories"
list_subcategoriesList technology subcategories. API Reference
  • "What subcategories exist under DevOps?"
  • "Show me the subcategories for cloud infrastructure"

Account tools

ToolDescriptionExample prompts
get_credit_balanceCheck your API credit balance. API Reference
  • "How many credits do I have left?"
  • "Check my TheirStack credit balance"
get_credits_consumptionView 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

How is this guide?

Last updated on

On this page

Connect to TheirStack's MCP server
Available tools
Search tools
Catalog tools
Account tools
Pricing
FAQs