Mock, intercept, and test HTTP APIs without leaving Cursor.
The Beeceptor plugin connects Cursor to your Beeceptor account via MCP, giving AI agents direct access to create and manage mock rules, inspect traffic, run chaos tests, and build stateful API simulations.
| Component | File | Purpose |
|---|---|---|
| MCP server | mcp.json |
Connects Cursor to the Beeceptor MCP API |
| Rule | rules/beeceptor-usage.mdc |
Best-practice guidance applied when working with Beeceptor tools |
| Skill | skills/mock-api-designer/ |
Design and scaffold mock APIs from a description or route list |
| Skill | skills/request-inspector/ |
Inspect and debug captured request history |
| Agent | agents/api-mock-setup.md |
End-to-end agent that sets up a complete mock from scratch |
| Agent | agents/chaos-tester.md |
Configures weighted error rates and latency injection for resilience testing |
| Command | commands/create-crud-mock.md |
One-shot CRUD resource scaffolding (/api/users, etc.) |
| Command | commands/inspect-recent-requests.md |
Fetch and summarize the latest requests on an endpoint |
Install from the Cursor Marketplace, or add the MCP server manually in Cursor settings:
{
"mcpServers": {
"beeceptor": {
"url": "https://mcp.beeceptor.com/mcp"
}
}
}When you first use the plugin, Cursor prompts you to connect your Beeceptor account. Complete the OAuth flow.
Once connected, Cursor's AI has access to the full Beeceptor toolset:
Endpoints
endpoint_list— list all endpoints and current selectionendpoint_select— switch active endpoint for this sessionendpoint_create_free— provision a new free endpointendpoint_info— get mock base URL for the active endpoint
Mock Rules
rule_list,rule_get,rule_create,rule_update,rule_deleterule_delete_all,rule_bulk_replace,rule_reorderrule_create_weighted— multi-outcome weighted responsesrule_create_callout— proxy/webhook forwarding rulesrule_create_crud— full CRUD resource on a path
Request History
request_history_list,request_history_getrequest_history_delete,request_history_purge
State Store
state_list,state_get,state_upsert,state_delete,state_delete_item
Settings & Utilities
settings_get,settings_updatesyntax_info— Handlebars + Faker reference
"Set up a mock for a User Service with GET /users, POST /users, and GET /users/:id returning realistic faker data."
The api-mock-setup agent (or the mock-api-designer skill) will:
- Provision or select an endpoint
- Create rules with dynamic faker responses
- Return the live mock URL and curl examples
"Show me the last 10 requests that hit my endpoint and flag any that didn't match a rule."
Use the inspect-recent-requests command or the request-inspector skill.
"Add a 20% chance of 503 and a 5% chance of a 10-second timeout on POST /checkout."
The chaos-tester agent will create weighted rules and latency injection targeting the specified routes.