Cursor Agent SDK: Build, Evaluate, and Deploy Agents as Code
Cursor's Agent SDK gives teams a code-first way to define, test, evaluate, and deploy AI agents. Its docs describe project instructions, tools, and evaluations as versionable files, with Markdown and TypeScript in the project. Developers can use Cursor-managed hosting or self-hosted infrastructure.
Cursor's Agent SDK gives developers a code-first way to define, test, evaluate, and deploy agents. Its docs describe Markdown and TypeScript files that combine deterministic code with model judgment, plus Cursor-managed or self-hosted deployment. (Cursor Agent SDK documentation)
Agents defined in files
The Agent SDK docs describe each agent as a project whose instructions, tools, and evals can be reviewed, tested, and versioned like code. Markdown and TypeScript combine deterministic code with model judgment, while the SDK's APIs connect agents to places such as Slack, pull requests, issue trackers, and Cursor. (Cursor Agent SDK documentation)
Cursor-hosted or self-hosted
Cursor documents two deployment choices: use Cursor-managed hosting, or run the agent on infrastructure you manage. (Cursor Agent SDK documentation)
The documented quick start installs the CLI, scaffolds a project, and starts a development session. Cursor's setup instructions call for Node.js 22.13 or newer. (Cursor Agent SDK documentation)
npm install --global @grok/agent-sdk
agent-sdk init ./my-bot
cd ./my-bot
agent-sdk dev
The setup guide also includes a browser sign-in step before initializing an agent project. (Cursor Agent SDK documentation)
Agent SDK and TypeScript SDK
Cursor's TypeScript SDK is a separate developer surface. Its documentation describes the @cursor/sdk package as a way for TypeScript to call the same Cursor agent available in the IDE, CLI, and web app. The Agent SDK documentation instead focuses on versioned agent projects made from instructions, tools, and evaluations. (Cursor TypeScript SDK documentation; Cursor Agent SDK documentation)
Sources
Read next
Related coverage- Cursor
Cursor SDK: Programmatic Cursor Agents in TypeScript and Python, Local or Cloud
Cursor launched its SDK in public beta on April 29, 2026 as a TypeScript package. As of October 9, 2026 it ships for TypeScript (`@cursor/sdk`) and Python (`cursor-sdk`), released together at version 1.0.35, and the docs no longer call it beta. Agents run locally, on Cursor-hosted VMs, or on self-hosted workers.
- Cursor
Cursor SDK Bridge Opens Agent Control to Rust, Go, and More
Cursor has open-sourced an SDK Bridge that exposes a stable sdk.v1 protocol for driving Cursor agents from Rust, Go, Java, and other languages. Adapters run a small local bridge and communicate over Connect RPCs, while the bridge handles the connection to Cursor's API.
- Cursor
Cursor SDK Adds Live Agent Steering and Background Subagent Results
Cursor SDK 1.0.31 returns background subagent results to the parent run and adds MCP tool annotations for custom tools. Live steering with run.steer() and replaceable system prompts are documented in the TypeScript SDK reference for local agents. As of October 7, 2026, the changelog is at 1.0.35 and 1.0.32 changed how steering behaves while an agent waits on background subagents.
- Cursor
Cursor Router: Auto Balance, Auto Intelligence, and Cost Modes
Cursor Router is the routing system behind Auto, and Cursor documents it as available only on Teams and Enterprise plans. Open the model picker, select Auto, and pick Cost, Balance, or Intelligence under Optimize For. Cost mode bills as a Cursor-model request from the weekly pool; Balance and Intelligence bill at the list price of whichever model the request is routed to.
Frequently Asked Questions
What does Cursor's Agent SDK do?
It lets teams define, test, evaluate, and deploy agents as code, with instructions, tools, and evaluations stored as project files.
What languages and files does the Agent SDK use?
The docs describe Markdown and TypeScript files that combine deterministic code with model judgment in an agent project.
Where can Agent SDK projects run?
Cursor documents both Cursor-managed hosting and self-hosted deployment.
How is the Agent SDK different from Cursor's TypeScript SDK?
The Agent SDK docs describe versioned agent projects for building and deploying agents as code. The separate `@cursor/sdk` package lets TypeScript call the same Cursor agent available in the IDE, CLI, and web app.
Get an email when Cursor changes its plans, prices or limits
We check every change against Cursor's own pages before we send. You also get the weekly AI Catchup; one click unsubscribes.