Prerequisites
Before you start, make sure you have:- An AIsa account (console.aisa.one). You sign in through the browser.
- Cursor installed
1. Add the AIsa MCP server
1
Open MCPs
In the Cursor sidebar, select Customize, then MCPs.
2
Add the server
Click New MCP Server. Cursor opens
~/.cursor/mcp.json. Add the AIsa entry and save the file:.cursor/mcp.json in that project.
2. Sign in
Under Customize → MCPs, aisa shows Needs authentication. Click Authenticate, sign in to AIsa in the browser, and approve access. No key is copied. When the connection is ready, aisa is listed under Connected with its enabled tool count.Use your API key instead of OAuth
Use your API key instead of OAuth
Pass the key as a Bearer header. Cursor resolves
${env:AISA_API_KEY} from the environment where it was launched, keeping the key out of the configuration file. Add export AISA_API_KEY="sk-aisa-..." to ~/.zshrc or ~/.bashrc, then quit Cursor and reopen it from a new terminal with cursor . (apps launched from the Dock may not inherit shell variables). An unset variable sends an empty token:Cursor CLI (cursor-agent)
Cursor CLI (cursor-agent)
cursor-agent reads the same mcp.json. Approve the server, then sign in:cursor-agent mcp list-tools aisa to confirm the tools are available.3. Use AIsa capabilities
Cursor’s agent now has the AIsa tools.search, list_categories, get_details, batch_get_schema, and batch_quote (prices exact calls without running them) are free; use and batch_use run calls and are billed per call.
Try:
Optional: use AIsa models
Cursor also accepts an OpenAI-compatible API key, so chat and agent requests can run on models from the AIsa catalog. This needs an AIsa API key (console.aisa.one/api-keys).1
Configure the endpoint
In Cursor Settings (gear icon) → Models → API Keys, paste your AIsa key (
sk-aisa-...) into OpenAI API Key and turn on Use OpenAI API Key. Then turn on Override OpenAI Base URL and enter https://api.aisa.one/v1.2
Add models
On the same page, click Add Custom Model and enter exact AIsa model IDs, for example
gpt-5.5, kimi-k2.5, claude-opus-4-8, or deepseek-v4.1-flash. Enable them, then pick one in the model picker. The full list is in the model catalog.Custom API keys apply to Cursor’s chat and agent requests. Cursor-native features such as Tab autocomplete continue to use Cursor’s own models and subscription.
Quick reference
Troubleshooting
Related
Use AIsa in Claude
Add AIsa as a custom connector in Claude.
Connect via MCP
MCP setup for other clients.
Model Catalog
Browse model IDs before adding them to Cursor.