# Jolts

> Company research for your AI agent. Connect with MCP or build with the HTTP API.

- [Company research. Built into your workflow.](https://dev.jolts.xyz/index.md): Find companies, understand relevant activity, and check the source with Jolts.
- [Your first company search](https://dev.jolts.xyz/quickstart.md): Ask a question, retrieve a company list, and inspect the evidence.
- [Authentication](https://dev.jolts.xyz/authentication.md): One account-scoped API key for HTTP and MCP.
- [Common questions](https://dev.jolts.xyz/faq.md): What Jolts does, who it helps, and what to expect before you connect.
- [How to find companies with an expressed need](https://dev.jolts.xyz/use-cases/find-active-demand.md): Turn what you sell into an evidence-backed prospect shortlist.
- [How to research accounts you already know](https://dev.jolts.xyz/use-cases/research-target-accounts.md): Check an inbound or CRM shortlist against the existing evidence dataset.
- [How to work with company lists](https://dev.jolts.xyz/workflows.md): Filter, paginate, investigate, and retry without duplicating work.
- [What Jolts data covers](https://dev.jolts.xyz/data-coverage.md): Supported observations, source evidence, freshness, and limits.
- [Understand your results](https://dev.jolts.xyz/evidence.md): Know what happened, why it might matter, and what the data cannot tell you.
- [Search best practices](https://dev.jolts.xyz/search-best-practices.md): Get a useful shortlist without overstating fit or repeating work.
- [How to troubleshoot a request](https://dev.jolts.xyz/troubleshooting.md): Tell a pending search, an empty result, and a failed request apart.
- [Search companies](https://dev.jolts.xyz/api-reference/companies/search-companies.md): Build a prospect shortlist from company activity relevant to what you sell. Describe the need in query; use filters for exact constraints and exclude_domains to leave out existing customers. Natural-language planning does not broaden the supported evidence kinds or countries.
- [Get company](https://dev.jolts.xyz/api-reference/companies/get-company.md): Unmetered, subscription-authorized corpus read. At most three recent current observations and domains supported by those observations; not a complete profile. Does not acquire data or call AI.
- [Get companies](https://dev.jolts.xyz/api-reference/companies/get-companies.md): Retrieve one to twenty known companies by IDs OR normalized domains. Exactly one array is required; no unfiltered listing is supported. No provider or AI calls run. Returns current supported domains and up to three recent observations per company, not a full profile. Each normalized distinct target…
- [Search observations](https://dev.jolts.xyz/api-reference/observations/search-observations.md): Find individual evidence-backed company activities using a literal query and exact filters. Unlike company search, this endpoint does not interpret the query through company-search planning or group results by company. Use short relevant terms, such as charging. Results are newest-observed first.
- [Get observation](https://dev.jolts.xyz/api-reference/observations/get-observation.md): Unmetered, subscription-authorized read with current evidence.
- [Start observation search](https://dev.jolts.xyz/api-reference/operations/start-observation-search.md): This existing endpoint queues observation searches. To queue companies use POST /api/companies/search with background:true.
- [Get operation](https://dev.jolts.xyz/api-reference/operations/get-operation.md): Account-scoped, unmetered polling or replay. Rechecks current evidence and subscription. No new external work.
- [Get subscription usage](https://dev.jolts.xyz/api-reference/account/get-subscription-usage.md): Unmetered allowance report shared by all credentials on this subscription.
- [Connect your AI assistant](https://dev.jolts.xyz/mcp-overview.md): Use the authenticated Streamable HTTP MCP interface.
- [Tool reference](https://dev.jolts.xyz/mcp-tools.md): Three tools for company discovery, dataset lookup, and account usage.
- [Read an MCP response](https://dev.jolts.xyz/mcp-responses.md): Tell a finished search from a pending request, an empty result, or an error.
- [How to connect Claude Code](https://dev.jolts.xyz/clients/claude-code.md): Connect Jolts over remote HTTP, keep your API key private, and verify the tool connection.
- [How to connect Codex](https://dev.jolts.xyz/clients/codex.md): Configure Jolts in Codex CLI with a private bearer-token environment variable.
- [How to connect Cursor](https://dev.jolts.xyz/clients/cursor.md): Add Jolts to Cursor using remote HTTP and a private environment variable.
- [How to connect Cascade](https://dev.jolts.xyz/clients/cascade.md): Configure the Cascade agent's remote Jolts connection.
- [How to connect VS Code](https://dev.jolts.xyz/clients/vscode.md): Connect Jolts over remote HTTP, keep your API key private, and verify the tool connection.
- [Search companies](https://dev.jolts.xyz/tools/search-companies.md): Find a prospect list supported by observed activity.
- [Look up known companies](https://dev.jolts.xyz/tools/get-companies.md): Inspect current evidence for up to twenty company IDs or domains.
- [Read usage and results](https://dev.jolts.xyz/tools/get-usage.md): Check account limits or retrieve an operation without starting another search.

## OpenAPI Specs

- [openapi](/openapi.json)