# 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.
- [How to work with company lists](https://dev.jolts.xyz/workflows.md): Filter, paginate, investigate, and retry without duplicating work.
- [Understand your results](https://dev.jolts.xyz/evidence.md): Know what happened, why it might matter, and what the data cannot tell you.
- [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.
- [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.
- [How to connect an agent](https://dev.jolts.xyz/mcp.md): Use the authenticated Streamable HTTP MCP interface.
- [Tool reference](https://dev.jolts.xyz/mcp-tools.md): Seven tools for company research, evidence, and account usage.

## OpenAPI Specs

- [openapi](/openapi.json)