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

# Connect to Cursor

> Use Ascend Gateway V5 as an MCP server in Cursor IDE.

# Connect to Cursor

Use the Ascend Gateway V5 as an MCP server in Cursor IDE for AI-powered GTM operations alongside your code.

## Setup

### Option 1: Project-Level (Recommended)

Create `.cursor/mcp.json` in your project root:

```json theme={null}
{
  "mcpServers": {
    "ascend-gateway": {
      "type": "http",
      "url": "https://ascend-gateway-v5.ascendgtm.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
```

### Option 2: Global

Add to `~/.cursor/mcp.json` (applies to all projects):

```json theme={null}
{
  "mcpServers": {
    "ascend-gateway": {
      "type": "http",
      "url": "https://ascend-gateway-v5.ascendgtm.workers.dev/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_TOKEN_HERE"
      }
    }
  }
}
```

### Option 3: OAuth (Auto-Discovery)

Cursor also supports the OAuth flow:

1. **Settings** → **MCP** → **Add Remote Server**
2. Enter: `https://ascend-gateway-v5.ascendgtm.workers.dev/mcp`
3. Complete the OAuth authorization (paste your bearer token)

## Test It

In Cursor's AI chat, ask:

```
Use the discover_apis tool to list my connected APIs
```

Or:

```
Search HubSpot for recent contacts using the hubspot_crm tool
```

## Available Tools

All 34 MCP tools are available — same as Claude and ChatGPT. See [MCP Tools Reference](/docs/reference/mcp-tools) for the complete list.

## Tips

* **Use with code context:** Cursor can combine gateway data with your codebase. Ask: "Based on the HubSpot contact data, generate a TypeScript interface for the contact schema."
* **Response trimming:** Use `fields` and `format` parameters to reduce response size. Cursor's context window benefits from compact responses.
* **Multiple projects:** Use project-level `.cursor/mcp.json` with different tenant tokens per project.

## Troubleshooting

| Issue               | Fix                                                              |
| ------------------- | ---------------------------------------------------------------- |
| Tools not appearing | Restart Cursor after adding `mcp.json`                           |
| "Connection failed" | Verify token: `curl -H "Authorization: Bearer TOKEN" .../health` |
| Slow responses      | Use `format: "compact"` to reduce response size                  |