> ## Documentation Index
> Fetch the complete documentation index at: https://dev.jolts.xyz/llms.txt
> Use this file to discover all available pages before exploring further.

# How to connect Cursor

> Add Jolts to Cursor using remote HTTP and a private environment variable.

## Configure the connection

Create a Jolts [API key](/authentication) and copy the company-data MCP endpoint from Jolts'
connection guide. Merge this into your project's `.cursor/mcp.json`:

```json theme={null}
{
  "mcpServers": {
    "jolts": {
      "url": "YOUR_MCP_ENDPOINT",
      "headers": { "Authorization": "Bearer ${env:JOLTS_API_KEY}" }
    }
  }
}
```

Replace the endpoint placeholder. Set `JOLTS_API_KEY` in the environment that launches Cursor,
then restart Cursor. Do not put the secret in this file, a prompt, or a screenshot.
For an all-project connection, use `~/.cursor/mcp.json` instead.

<Note>
  Cursor's `envFile` setting applies to local STDIO servers, not remote HTTP servers.
  Putting a key in your project's `.env` alone does not configure this connection.
</Note>

## Verify and use it

Enable Jolts in Cursor's MCP settings and review any trust request. In Agent, ask to inspect
Jolts' tools without running a search. Expect `search_companies`, `get_companies`, and `get_usage`.
Call `get_usage` without arguments first to check your allowance at no usage charge.

Try [researching known accounts](/use-cases/research-target-accounts) or
[finding active demand](/use-cases/find-active-demand). Review the tool call before approving:
searches and company lookups consume your account's shared allowance.

## Troubleshooting

An authentication failure usually means Cursor cannot read the environment variable or the key
was revoked. A connected server with unavailable tools may be restricted by organizational policy.
A company-operation error is separate from connection setup; consult [troubleshooting](/troubleshooting).
Jolts does not currently offer OAuth login.

See [Cursor's official MCP guide](https://cursor.com/docs/mcp) and the
[Jolts tool reference](/mcp-tools).