Introduction
What is MCP?
The Model Context Protocol (MCP) is an open standard for connecting AI assistants to external data and tools. The Org provides an MCP server so you can use Claude, Cursor, and other MCP-compatible clients to query companies, people, open jobs, org charts, reporting lines, positions, contact details, people/lead lists, and API usage in natural language.
MCP server URL
https://api.theorg.com/v1.1/mcpPaste this URL into Cursor, Claude, ChatGPT, or any other MCP-compatible client. For client-specific setup, see Get started.
What you can do
Once connected, your AI assistant can call these tools on your behalf:
| Tool | Description | Credits |
|---|---|---|
| search_companies | Look up companies by name, domain, email, or LinkedIn company URL/slug | Free |
| get_company | Get a company profile: description, size, location, industries, funding | Free |
| get_org_chart | Get an iframe embed URL for a company’s org chart (by domain or LinkedIn URL/slug) | Free |
| find_person | Look up a specific person by LinkedIn URL/slug, or by full name + company name/domain | Free |
| find_jobs | Search open job vacancies by job URL/slug, title, company, or filters. Max 25 results | Free |
| get_manager | Find the manager of a person (by position ID, work email, or LinkedIn URL/slug) | 1 per find |
| get_reports | Find the direct reports of a person (by position ID, work email, or LinkedIn URL/slug) | 1 when reports are found |
| find_positions | Search positions/people with filters (company, department, job titles, etc.). Max 25 results per call | 1 per row returned |
| resolve_contacts | Resolve work emails for up to 25 people found via find_positions or find_person | 1 per person newly resolved |
| get_lists | List people/lead lists for your account (owned and shared) | Free |
| add_to_list | Add people (position IDs from find_positions / find_person) to an existing list. Max 25 IDs per call | Free |
| create_list | Create a people/lead list and optionally add position IDs in the same call. Max 25 IDs | Free |
| get_usage | Check your remaining API credits and usage | Free |
List tools return links like https://theorg.com/people/lists/{slug} (for example https://theorg.com/people/lists/empty-list).
Credits are deducted from the same balance as your API usage. List tools do not consume credits. Re-resolving a contact your account has already paid for is free.
Integration with AI assistants
The MCP server works with any client that supports MCP over HTTP, including:
- Claude Desktop – via mcp-remote and your config file
- Cursor – built-in MCP support in Settings
Authentication uses your existing API key . No separate MCP sign-up is required.
For setup, see Get started. For endpoint details, protocol, and examples, see the MCP API reference.