Skip to main content
New tools, parameters, pricing and behavior changes in the Specter MCP server, newest first. Use the tags to filter by area. Changes to the REST API are tracked separately in the API changelog, and changes to the delivered datasets in the dataset changelog. Bookmark this page for updates. If an update is unclear or you need help planning a migration, email api-support@tryspecter.com.
People

New: education details on get_person_profile

get_person_profile returns more of a person’s education, matching the REST API’s person endpoint.
  • The response has education_level (the highest level reached, such as Doctoral degree) and last_updated.
  • Each education entry has description (research focus, honours, modules, and a grade written as text), location and school_linkedin_url.
What to do: nothing. The fields are additive. A value Specter does not hold is null.
Saved searchesSearch

New: the company ID on talent signals

A talent signal returned by get_saved_search_items or search has current_position_company_external_id: the ID of the company the person’s current position is at, as get_company_profile and the other company tools take it. It is null when Specter holds that company only by name.What to do: nothing. The field is additive.
People

Changed: get_person_email returns professional addresses only

get_person_email answers with a person’s professional (work) address. It no longer returns a personal address, and no longer falls back to one when no professional address is on file: that call now fails with “No email found”, as a call for a person with no address at all always did. The response’s email_type is always professional.email_type is still accepted and is now refused. A call that passes it — any value, including professional — fails with “email_type is no longer supported: get_person_email returns professional (work) email addresses only.” The parameter was kept rather than removed so that a call written against the old behavior fails with that message, instead of quietly returning a different kind of address.What to do: drop email_type from your calls. A call that selected professional returns what it always did. A call that selected personal, or that relied on either falling back to a personal address, no longer receives one.
ListsSaved searches
Four tools return new fields. Nothing was removed or renamed, and no input changed.get_lists
  • Each list has custom_fields: the list’s own columns beyond Specter’s data.
  • The response has workspace_custom_fields: the columns every list of that product shows, shared cell for cell. When a list has its own column with the same name, the list’s own column is the one it means.
Each column carries:get_list_items
  • The response has custom_fields: the list’s columns, in the shape above.
  • Each item has custom_fields: its values in those columns, keyed by column name. A select value is given by its label. A column the item has no value in is absent.
create_list and create_saved_searchBoth return created. It is false when you already had a list of that name and product, or a saved search of that name over that query, and that one was returned instead of a new one. create_list still adds any requested items the list did not hold yet.What to do: nothing. The fields are additive. Read created to tell a new list or search from one you already had.
Search
The response has sort: the order items are in, as a list of {field, direction}. It is the sort you passed, or the order the search’s builder suggested when you passed none. It is empty for the product’s default order.What to do: nothing. The field is additive.
Investors

New: portfolio_company_count on get_investor_profile

The response has portfolio_company_count: how many companies the investor’s whole portfolio holds. portfolio_companies lists at most 25 of them.What to do: nothing. The field is additive.
Companies

New: relationship on get_company_profile

The response has relationship: the company’s current corporate relationship, meaning who acquired it or it is part of. It is null when the company has none.What to do: nothing. The field is additive.
Investors

Changed: get_investor_profile lists at most 25 portfolio companies

portfolio_companies holds at most 25 company IDs: the companies the investor backed across the most rounds, most first. A large fund’s whole portfolio ran to thousands of IDs, which made one profile too large to use.What to do: to work through a whole portfolio, page through get_investor_funding_rounds, which lists every round the investor joined with the company it funded.
Saved searches

Removed: signal_mode='new' on get_saved_search_items

signal_mode='new' applied a fixed time window: the current month for company searches, the current week for talent-signal and interest-signal searches. The value is no longer accepted. A call that sends it fails with the same “not valid for this search” error as any other unsupported signal_mode.To select results by time, pass a cutoff:
  • new_results_after returns the results added after the given timestamp.
  • since_last_viewed returns the results added since the saved search was last opened.
signal_mode='new_talent_signals' on a people search is unaffected.What to do: replace signal_mode='new' with new_results_after or since_last_viewed.