MCP
Every lookup and research tool uses the REST operation schemas and billing scopes. Ordinary job tools create, list, inspect, cancel and follow long-running lookups. Supported legacy versions are 2025-03-26, 2025-06-18 and 2025-11-25. The stateless 2026-07-28 adapter usesserver/discover, client metadata and matching routing headers on every request. OAuth supports client metadata documents and retains dynamic registration for older clients.
DeepSearch also exposes a hosted MCP server for agents and IDEs that support Streamable HTTP. Use the same API key as a bearer token; scopes, expiry, rate limits, wallet metering, and onboarding errors behave the same as REST.
This server is published in the as app.deepsearch/deepsearch. That entry names https://deepsearch.app/api/mcp as its remote, so a client can confirm from the registry's side that this is the endpoint we publish.
https://deepsearch.app/api/mcphttps://deepsearch.app/.well-known/oauth-protected-resourcesearch_peoplebuild_dossierask_about_personresearchsearch_companiesbuild_company_dossierreverse_image_searchlookup_vinlookup_addressget_lookup_job_eventscreate_lookup_jobget_lookup_jobcancel_lookup_joblist_lookup_jobsDEEPSEARCH_API_KEY in your MCP client's local secret store or environment. Do not commit a plaintext key inside mcp.json.Example prompts
What each tool is for, in the words a user would actually type. Names and addresses below are invented.
“Compare the legal entities for Northwind Robotics, then build a sourced report for the company I select.”
Retains the selected company's domain, registry identifier and jurisdiction.
“Research how Northwind Robotics positions itself against its three largest competitors, with sources.”
One multi-step research run reconciles many sources into a cited report, instead of a page of search results.
“Find public appearances of this image URL, then decode the VIN I provided from a vehicle listing.”
Separates public image matches from vehicle evidence and reports missing information honestly.
“Northwind Robotics may lease the office at 18 Harbor Point Way, Northwind Bay. Before we sign, summarize the building, its flood and hazard risk and what is nearby.”
Describes the place only - building, hazards, schools and nearby places - and never names anyone who lives at or owns an address.
“Start an asynchronous sourced company lookup, check its progress and my existing jobs, then cancel it if I ask.”
Uses durable developer jobs for longer research and cancels only when requested.
“A candidate applied with the address jordan.avery@example.com. Which public profiles match it?”
Resolves one identifier to ranked candidates with confidence scores, instead of pages to reconcile by hand.
“I meet Dana Whitfield of Northwind Robotics tomorrow. Build me a sourced profile of her public background.”
Correlates accounts across platforms into one profile, with every claim linked to the page it came from.
“Where does Dana Whitfield work now, and which public source says so?”
One grounded fact and its citation - cheaper and more direct than building the whole profile.
“Find whoever is behind the handle @dwhitfield, then give me their full public footprint.”
The usual chain: disambiguate first, then profile the candidate the user picked.
“A source tells me they were head of engineering at Northwind Robotics. Is that supported by public records?”
Verification against cited public sources, rather than taking a stated role at face value.