Agent Setup

Cursor

Quick answer

Cursor talks to providers through an OpenAI-compatible endpoint. Point its OpenAI base URL override at http://127.0.0.1:11434/v1 with the key prismand Cursor's requests flow through your Prism providers. Cursor is not auto-configured — this is a manual, two-field change.

Last updated 2026-10-06Reviewed against Prism v0.3.26

Setup

Open Cursor's model settings

Go to Settings → Models.

Enable and set the base URL override

Turn on Override OpenAI Base URL and set it to http://127.0.0.1:11434/v1. The /v1 suffix is required.

Set the API key

Enter prism. This is Prism's fixed local token — it is not a secret and never leaves your machine.

Add your models

Add a custom model entry for each Prism model you want, using the model's route key as the name.

Base URL:  http://127.0.0.1:11434/v1
API Key:   prism
Model:     <your Prism model route key>

Cursor is not one of the one-click agents

Prism does not detect or write Cursor's config, so nothing is backed up or auto-synced here. Adding a model in Prism does not automatically add it to Cursor — you add the model name in Cursor as well.

Which endpoints Cursor uses

Cursor feature	Prism endpoint
Standard chat and agent requests	/v1/chat/completions
Completions with a Responses-style client	/v1/responses
Model discovery, where Cursor asks for it	/v1/models

Prism accepts both Authorization: Bearer prism and x-api-key: prism, so whichever header Cursor sends works.

Aliasing Cursor's model names

Cursor sends whatever model name you selected. If that name is not in your Prism catalog, Prism serves your default model instead. To keep a familiar name in Cursor's picker while running a different upstream model, add an alias:

{
  "aliases": {
    "gpt-4o": "glm-5.1:cloud",
    "claude-3-5-sonnet-20241022": "glm-5.1:cloud"
  }
}

See Model Remapping for the full alias rules.

MCP servers in Cursor

Cursor manages its own MCP servers, and Prism does not write that config. If you want Cursor to reach the MCP servers you enabled in Prism, add the gateway to Cursor's MCP config as a remote server pointing at http://127.0.0.1:11434/mcp with the header Authorization: Bearer prism. See MCP Gateway for the endpoint shape and the per-agent allowlist variant.

Verify it is working

Send a prompt in Cursor

Any chat or inline edit will do.

Check the Stats tab

The request appears in the Stats tab with Cursor detected as the client. If nothing appears, check that Prism is running and the base URL includes /v1.