Change Log

Lists API and MCP people/lead list tools

Released: 2026-07-23

Lists API

New Lists API endpoint to read people/lead lists for the authenticated account:

GET https://api.theorg.com/v1.1/lists

Also available on v1.2. Free. Each list includes id, name, slug, url (https://theorg.com/people/lists/{slug}), and positionCount when available.

MCP people/lead list tools

The MCP API includes free tools for Vision people/lead lists:

• get_lists – List owned and shared lists (same data shape as the Lists API).
• create_list – Create a list and optionally add up to 25 positionIds from find_positions in the same call.
• add_to_list – Add up to 25 positionIds to an existing list by listId or slug.

Also documented: MCP find_positions returns at most 25 rows per call (stricter than the Position API page size of up to 1000). Typical flow: find_positions → create_list / add_to_list.

MCP tools expanded

Released: 2026-07-22

The MCP API tool catalog now includes:

• search_companies – Company lookup by name, domain, or email (free).
• find_positions – Full filter schema documented in tools/list (company domains, job titles, departments, names, etc.).

Existing tools (get_org_chart, get_manager, get_usage, find_positions) remain unchanged in behavior. Server info version is now 1.1.

Org Chart v1.2.0

Released: 2026-03-11

Company API – Org Chart v1.2

A new version of the org chart endpoint is available:

GET https://api.theorg.com/v1.2/companies/org-chart

Changes in v1.2.0:

1. No unplaced section – The endpoint no longer supports the unplaced section. Only nodes in the org chart or board are returned.
2. Section parameter – The section query parameter accepts orgChart or board and defaults to orgChart.
3. Leaner nodes – linkedinUrl and workEmail are no longer included in org chart nodes in the response. To get contact details and other fields, enrich nodes by their id using the Position API (e.g. by position id or by looking up the node id).

MCP Integration

Released: 2026-02-24

This release adds support for the Model Context Protocol  (MCP):

• MCP Integration – New documentation section with Introduction and Get started for connecting Claude Desktop and Cursor to The Org’s data.
• MCP API – New endpoint for MCP over Streamable HTTP. See MCP API reference.

POST https://api.theorg.com/v1.1/mcp

Authentication uses the same API key (X-Api-Key header). Initial tools: get_org_chart, get_manager, get_usage, find_positions. See the later changelog entry for the expanded tool set. Credit costs match the existing Company API and Position API.

Org Chart v1.1.0

Released: 2025-10-27

Company API

This release introduces the following changes to the Company API:

GET https://api.theorg.com/v1.1/companies/org-chart

1. The endpoint now returns all nodes associated with a company. The Org maintains a backlog of positions and jobs that are not yet placed in the company org chart, but are still associated with the company. Previously only placed positions and jobs were returned, now both positions and jobs are returned and a section property is added to indicate whether these nodes are part of the orgChart, boardAndAdvisors or whether they are unplaced.

2. A parameter has been added to the endpoint to filter the results by section.

   GET https://api.theorg.com/v1.1/companies/org-chart?domain=theorg.com&section=orgChart

   Parameter	Type	Description	Required
   section	query	Section to filter by	false

   The section can be one of the following:

   • orgChart
   • board
   • unplaced

Migrating from v1 to v1.1

Simply include the section parameter set to orgChart to get the same results as before, the section property can be ingnored in this case.