Beeceptor Connector for AI agents.

29 live capabilities

Build and test mock APIs and HTTP proxies with real-time request logs.

Live agent request Beeceptor / Connector

Waiting for input…

AI Agent

Why people use Beeceptor

Beeceptor Mock API Testing for Faster Development

Beeceptor changes that. You can tell your agent to create mock rules or upload a spec to generate a live environment. You get a working endpoint in seconds so you can keep coding the frontend.

What Vinkius changes

You get a live, programmable mock environment that your agent can control and monitor in real-time.

Use it from Claude, ChatGPT, Cursor or another AI client you already have.

One account · 5,900+ Connectors

Real-world use case 01

Frontend Mocking

A developer needs to build a checkout page but the payment API isn't ready.
Real-world use case 02

Webhook Debugging

A dev is confused why a stripe webhook isn't firing.
Real-world use case 03

Edge Case Testing

A QA engineer wants to see if the app crashes on a 503 error.

Complete set · 29capabilities

The complete Beeceptor capability set.

These are the exact actions your AI can choose when you ask it to work with Beeceptor.

Capability set01 / 08

01—04

4 capabilities in this set.

Part of 29 available through Beeceptor.

01 Capability
Delete state
Remove specific items from your mock state. This helps keep your state storage clean.
02 Capability
Download multipart
Download a multipart file from a request. Use this to inspect file uploads in your logs.
03 Capability
Get job status
Check the status of a specification upload job. This helps you know when your mock is ready.
04 Capability
Get request
Fetch the details of one specific request. This lets you drill down into a single interaction.

Capability set02 / 08

05—08

4 capabilities in this set.

Part of 29 available through Beeceptor.

05 Capability
Get rule
Retrieve details for one mock rule. Use this to see the exact configuration of a specific path.
06 Capability
Get settings
View your current endpoint settings. This shows your active CORS and logging configurations.
07 Capability
Get spec details
Get the details of a specific API specification. This confirms what was uploaded to your mock.
08 Capability
Get state item
Fetch a single item from your state storage. Use this to get data used in previous requests.

Capability set03 / 08

09—12

4 capabilities in this set.

Part of 29 available through Beeceptor.

09 Capability
List certificates
See all mTLS certificates currently active. This helps you manage your proxy security.
10 Capability
List requests
Get a list of all incoming request history. This is your primary way to debug webhooks.
11 Capability
List rules
See all active mock rules for your endpoint. Use this to audit your current mock behavior.
12 Capability
List state
View all current state items. Use this to see what data your mock is currently holding.

Capability set04 / 08

13—16

4 capabilities in this set.

Part of 29 available through Beeceptor.

13 Capability
Upload spec
Upload an OpenAPI or Swagger file. This automatically generates mock endpoints from your docs.
14 Capability
Upsert state
Bulk update or insert items into your mock state. This is the fastest way to seed state data.
15 Capability
Add certificate
Add an mTLS certificate to your proxy. This is necessary for secure, authenticated connections.
16 Capability
Bulk replace rules
Swap out multiple mock rules at once. It's much faster than updating rules one by one.

Capability set05 / 08

17—20

4 capabilities in this set.

Part of 29 available through Beeceptor.

17 Capability
Create rule
Create a new mock rule for a specific endpoint. This defines how the agent responds to a request.
18 Capability
Delete all rules
Wipe every mock rule from your current setup. Use this to reset your environment completely.
19 Capability
Delete certificate
Remove an mTLS certificate from your proxy. This clears out old security credentials.
20 Capability
Delete request
Remove a single request from your history. This keeps your logs focused on what matters.

Capability set06 / 08

21—23

3 capabilities in this set.

Part of 29 available through Beeceptor.

21 Capability
Delete requests
Clear out your entire request history. It's the quickest way to wipe your logs.
22 Capability
Delete rule
Delete a specific mock rule. Use this when you no longer need a particular behavior.
23 Capability
Delete spec
Remove an uploaded API specification. This clears out old documentation from your mock environment.

Capability set07 / 08

24—26

3 capabilities in this set.

Part of 29 available through Beeceptor.

24 Capability
Delete state item
Delete a single item from your state. This is useful for targeted state cleanup.
25 Capability
Reorder rules
Change the sequence of your mock rules. This is important when multiple rules might match a path.
26 Capability
Update rule full
Update every part of a mock rule. Use this for significant changes to an endpoint's behavior.

Capability set08 / 08

27—29

3 capabilities in this set.

Part of 29 available through Beeceptor.

27 Capability
Update rule partial
Change just one part of a mock rule. This is the way to go for small tweaks like a status code.
28 Capability
Update settings
Change your endpoint settings like CORS or logging. Use this to adjust your proxy configuration.
29 Capability
Upload blob
Upload a binary blob for your mock. This allows you to serve static data from your mock.

Set up in minutes

One URL. Then ask Beeceptor to work.

Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Beeceptor from the conversation.

Choose your client

Live preview

Advanced clients IDE · CLI

Claude · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp

Step 01

Open Connectors

In Claude Web or Claude Desktop, open Settings and choose Connectors.
Step 02

Add the URL

Choose Add custom connector, name it Beeceptor, and paste the URL above.
Step 03

Turn it on in chat

Select +, open Connectors, and enable Beeceptor for the conversation.

ChatGPT · Web + desktop

Official guide ↗

Connector URL · ready to paste

Streamable HTTP

https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp

Step 01

Open MCP settings

On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
Step 02

Add the URL

Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Beeceptor URL.
Step 03

Save and start

Save the connection and enable Beeceptor in your conversation. Desktop may ask you to restart once.

Cursor · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "beeceptor": {
      "url": "https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp"
    }
  }
}

Step 01

Open MCP Settings

Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
Step 02

Add the server config

Paste the JSON configuration above into the mcp.json file that opens
Step 03

Save the file

Cursor will automatically detect the new Connector
Step 04

Start using Beeceptor

Open Agent mode in chat and ask: "Using Beeceptor, help me...". 29 tools available

VS Code Copilot · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "beeceptor": {
      "url": "https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp"
    }
  }
}

Step 01

Create MCP config

Create a .vscode/mcp.json file in your project root
Step 02

Add the server config

Paste the JSON configuration above
Step 03

Enable Agent mode

Open GitHub Copilot Chat and switch to Agent mode using the dropdown
Step 04

Start using Beeceptor

Ask Copilot: "Using Beeceptor, help me...". 29 tools available

Windsurf · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "beeceptor": {
      "url": "https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp"
    }
  }
}

Step 01

Open MCP Settings

Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
Step 02

Add the server

Paste the JSON configuration above into mcp_config.json
Step 03

Save and reload

Windsurf will detect the new server automatically
Step 04

Start using Beeceptor

Open Cascade and ask: "Using Beeceptor, help me...". 29 tools available

Cline · IDE configuration

Official guide ↗

Advanced setup

{
  "mcpServers": {
    "beeceptor": {
      "url": "https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp"
    }
  }
}

Step 01

Open Cline MCP Settings

Click the Connectors icon in the Cline sidebar panel
Step 02

Add remote server

Click "Add Connector" and paste the configuration above
Step 03

Enable the server

Toggle the server switch to ON
Step 04

Start using Beeceptor

Ask Cline: "Using Beeceptor, help me...". 29 tools available

Claude Code · Terminal command

Official guide ↗

Advanced setup

claude mcp add beeceptor --transport http "https://edge.vinkius.com/vk_preview_yMcAgY4AoI9RN5MBzAq1ZxJ0JFyGbDPrTCKLzG2z/mcp"

Step 01

Install Claude Code

Run npm install -g @anthropic-ai/claude-code if not already installed
Step 02

Add the Connector

Run the command above in your terminal
Step 03

Verify the connection

Run claude mcp to list connected servers, or type /mcp inside a session
Step 04

Start using Beeceptor

Ask Claude: "Using Beeceptor, show me...". 29 tools are ready

Where the request belongs

Work Beeceptor can move forward.

Built around the request

This is for developers who need to move fast on the frontend without waiting for backend completion, or QA engineers who need to force specific error codes and edge cases.

01

Frontend Developer

Mocks backend dependencies to keep UI development moving without blocker issues.

02

QA Engineer

Simulates timeouts and 500 errors to see how the application handles failures.

03

Backend Engineer

Inspects incoming webhook payloads to ensure third-party integrations are working.

Build the capability set

Each Connector adds new actions and data without changing how you work.

Browse Connectors

01 9 capabilities

Postman

Design, test, and document APIs collaboratively with the world most popular API development platform used by millions of developers.

02 17 capabilities

Webhook.site

Test and debug webhooks and HTTP requests. Create custom URLs, inspect incoming payloads, and automate responses via AI.

03 25 capabilities

Reqres

Test your front-end against a real API. manage users, resources, and project records for prototyping and testing.

04 6 capabilities

Moesif

Monitor and analyze API traffic with Moesif. log events, track user/company profiles, and query API analytics directly from your AI agent.

05 1 capability

Treblle

Monitor, document, and analyze your API traffic in real-time. Ingest request and response data directly into Treblle for instant observability.

06 1 capability

ReqBin

Test and verify API requests using ReqBin Echo. send JSON payloads and inspect the echoed response to debug request structures.

Bring your own AI

Change the model, client or framework. Keep Beeceptor connected.

Before you connect

Questions about Beeceptor.

The practical details behind the request, access and result.

What does Beeceptor MCP do for my development?

It lets you create mock APIs and proxies that your agent can interact with. You can simulate real backend behavior without actually building the backend yet.

Can I use Beeceptor MCP to test webhooks?

Yes. You can use it to intercept and view every request that hits your proxy, making it easy to see the exact data being sent by third-party services.

How does Beeceptor MCP handle API documentation?

You can upload OpenAPI or Swagger specs, and the Connector will automatically turn those definitions into mock endpoints for you.

Can I store data in Beeceptor MCP?

Yes, it includes state management capabilities. You can save and retrieve information across different requests, which is great for simulating things like user sessions.

Is Beeceptor MCP good for QA testing?

It's perfect for QA. You can easily set up rules that return specific error codes or simulate slow responses to see how your app handles failures.

Can I manage security with Beeceptor MCP?

You can manage mTLS certificates through the Connector, allowing you to set up secure, authenticated connections for your mock environment.

How does Beeceptor MCP help with frontend work?

It removes the blocker of waiting for backend APIs. You can get a functional mock environment immediately so you can build out your UI.

Can I enable CORS for my mock endpoint through the AI?

Yes. You can use the update_settings capability to toggle CORS, request logging, and other endpoint features instantly.

How do I see the payloads of recent requests sent to my Beeceptor subdomain?

Use the list_requests capability. It retrieves a list of recent incoming HTTP calls, allowing your agent to analyze headers and body content.

Is it possible to simulate a database or state between API calls?

Yes, Beeceptor provides a key-value store. You can use upsert_state to save data and get_state_item to retrieve it in subsequent mock responses.

One connection away

Give your agent a direct line to Beeceptor.

Connect Beeceptor once. Keep it beside 5,900+ managed Connectors when the next task needs more.

Explore every Connector No credit card required · Free tier available