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

# Cursor

> Add Bifrost as a custom model in Cursor, configure MCP tools, and use virtual keys for team access control.

[Cursor](https://cursor.com) is an AI-powered IDE that supports OpenAI-compatible APIs and MCP (Model Context Protocol). By connecting Cursor to Bifrost, you get access to any provider/model in your Bifrost configuration, plus MCP tools and governance features like virtual keys.

<img src="https://mintcdn.com/bifrost/1EseDl-gFo3GVREO/media/ides/cursor-add-custom-model-1.png?fit=max&auto=format&n=1EseDl-gFo3GVREO&q=85&s=29f2caed1bfa15296c6243d6baa46eeb" alt="Setting up Bifrost for Cursor" width="2628" height="2006" data-path="media/ides/cursor-add-custom-model-1.png" />

<Note>
  If your Allowed Headers are already set to `*`, you can skip this note. If not and you face issues integrating Bifrost with Cursor, try switching to `*` or adding the specific headers required by your client. By default, Bifrost whitelists: `Content-Type`, `Authorization`, `X-Requested-With`, `X-Stainless-Timeout`, and `X-Api-Key`.
</Note>

## Setup

1. **Open Cursor Settings**

   Press <key>Cmd</key>+<key>,</key> (macOS) or <key>Ctrl</key>+<key>,</key> (Windows/Linux) and navigate to **Models**.

2. **Enter your API key**

   In the **OpenAI API Key** field, enter your Bifrost virtual key or provider API key.

3. **Override the base URL**

   Toggle **Override OpenAI Base URL** to ON and enter your Bifrost endpoint:

   <Note>
     For cursor you need publicly accessible link for Bifrost.
   </Note>

   For deployed instances, use your Bifrost deployment URL (e.g., `https://bifrost.example.com/cursor`).

4. **Add custom models** (optional)

   Type a model name in the **Add or search model** field using the `provider/model-name` format:

   <img src="https://mintcdn.com/bifrost/xgjlc2GaeoOdmpFM/media/ides/cursor-add-custom-model-4-custom-model.png?fit=max&auto=format&n=xgjlc2GaeoOdmpFM&q=85&s=0cd881dbdf2c1a1b98ce1fbdf1c2f64a" alt="Adding a custom model in Cursor" width="2430" height="1960" data-path="media/ides/cursor-add-custom-model-4-custom-model.png" />

   Examples: `anthropic/claude-sonnet-4-5-20250929`, `openai/gpt-5`, `gemini-2.5-pro`

   | Provider            | Format                 | Example                                |
   | ------------------- | ---------------------- | -------------------------------------- |
   | Anthropic           | `anthropic/model-name` | `anthropic/claude-sonnet-4-5-20250929` |
   | Gemini              | `model-name`           | `gemini-2.5-pro`                       |
   | OpenAI              | `openai/model-name`    | `openai/gpt-5`                         |
   | Bedrock             | `bedrock/model-name`   | `bedrock/anthropic.claude-3`           |
   | Vertex (non-Gemini) | `vertex/model-name`    | `vertex/text-bison`                    |
   | Other providers     | `provider/model-name`  | `groq/llama-3.3-70b-versatile`         |

## Using Virtual Keys

Bifrost [Virtual Keys](/features/governance/virtual-keys) can be used as the OpenAI API Key in Cursor. Virtual keys let you enforce budgets, rate limits, and provider access controls for each user or team.

## Model Selection

Cursor assigns models to different features - **Chat**, **Agent**, **Inline Edit**, and **Tab Completion**. After configuring Bifrost, you can assign any `provider/model-name` to each feature for optimal cost and performance:

* Use a powerful model like `openai/gpt-5` or `anthropic/claude-sonnet-4-5-20250929` for Agent mode
* Use a fast model like `groq/llama-3.3-70b-versatile` for Tab completion

## Using Multiple Providers

Bifrost routes requests to the correct provider based on the model name. Use the `provider/model-name` format to access any configured provider through the single OpenAI-compatible endpoint:

```
anthropic/claude-sonnet-4-5-20250929
openai/gpt-5
gemini/gemini-2.5-pro
mistral/mistral-large-latest
```

### Supported Providers

Bifrost supports the following providers with the `provider/model-name` format:

`openai`, `anthropic`, `azure`, `gemini`, `vertex`, `bedrock`, `mistral`, `groq`, `cerebras`, `cohere`, `perplexity`, `xai`, `ollama`, `openrouter`, `huggingface`, `nebius`, `parasail`, `replicate`, `vllm`, `sgl`

<Warning>
  Non-native models **must support tool use** for Cursor's agent mode and inline editing to work properly. Models without tool use support will only work for basic chat.
</Warning>

<Note>
  Cursor's "Override OpenAI Base URL" is a global setting that applies to all OpenAI-compatible models. This works well with Bifrost since Bifrost handles routing to the correct provider based on the model name.
</Note>

## Observability

All Cursor requests through Bifrost are logged. Monitor them at `http://localhost:8080/logs` - filter by provider, model, or search through conversation content.