# The Org — how to use (mcp.ai)

Connect your The Org account and use 8 tools for sales and CRM straight from your AI agent. Connect with your own API key. The Org provides company org charts, people and position search, manager lookup, lead lists, and account usage data.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_the_org?ms=1787293500000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `the_org_estimate_position_search_cost`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/the_org`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/the_org/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/the_org/estimate/position/search/cost` — Estimate the credits required for one page of a position search without consuming credits. Use the same limit, offset, and filters with Search Positions if the estimate is acceptable.
  - body: { limit?: integer, offset?: integer, filters: object }
- `POST https://api.mcp.ai/api/the_org/get/current/usage` — Return the connected account's current credit allowance, billing interval, reset date, additional credits, overages, and unlimited status.
- `POST https://api.mcp.ai/api/the_org/get/manager` — WARNING: Each successful lookup costs 1 credit. Find a person's org-chart manager by work email or LinkedIn profile URL.
  - body: { email?: string, linked_in_url?: string }
- `POST https://api.mcp.ai/api/the_org/get/org/chart` — Return a company's current v1.2 org chart or board as a flat node list. A successful request costs 10 credits, although repeats for the same company within 24 hours are not charged again.
  - body: { domain?: string, section?: string, linked_in_url?: string }
- `POST https://api.mcp.ai/api/the_org/get/usage/history` — Return daily or monthly historical usage for one API product over an inclusive date range.
  - body: { to_date: string, interval?: string, from_date: string, api_product: string }
- `POST https://api.mcp.ai/api/the_org/list/people/lists` — Return people and lead lists owned by or shared with the connected account, one page at a time.
  - body: { limit?: integer, offset?: integer }
- `POST https://api.mcp.ai/api/the_org/search/companies` — Find companies by name, domain, or email without consuming credits. Provide at least one search identifier; prefer one when possible.
  - body: { email?: string, limit?: integer, query?: string, domain?: string }
- `POST https://api.mcp.ai/api/the_org/search/positions` — Search people and positions using company, role, hierarchy, location, funding, and contact filters. This request consumes 1 credit per returned row; call Estimate Position Search Cost first when cost 
  - body: { limit?: integer, offset?: integer, filters: object }

## Example prompts
- "What can I do in The Org?"
- "Show me a summary of my The Org account"

## More
- Page: https://mcp.ai/the_org
- Agent spec (llms.txt): https://mcp.ai/the_org/llms.txt
- Postman collection: https://mcp.ai/the_org/postman.json