Webhook.site MCP. Debug incoming webhooks and API payloads instantly.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Webhook.site lets your AI agent manage and inspect HTTP webhooks directly through the MCP Server. Create custom webhook URLs (tokens) on the fly to capture incoming requests.
You can read raw headers, check query parameters, view JSON payloads, and even force specific API responses—all without setting up local tunnels or writing server code.
What your AI agents can do
Create action
Sets up a custom automated action for a specific webhook token.
Create global variable
Establishes a persistent variable that the agent can reference across different test sessions.
Create token
Generates and registers a new, unique webhook URL (token) for testing purposes.
Generates a new, unique webhook URL (token) with an alias and specific default response settings.
Retrieves detailed metadata for any webhooks captured by a token, including raw headers, query parameters, and payload data.
Sets custom HTTP status codes, response headers, or body content to simulate complex API behavior for testing purposes.
Creates and updates global environment variables that maintain context across multiple webhook test sessions.
Executes pre-configured actions against a specific request's history, allowing for automated testing workflows.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Webhook.site MCP Server: 17 Tools for Webhook Management
These tools let your agent manage the full lifecycle of webhook endpoints: creating them, inspecting incoming data, simulating failures, and running automated actions.
019e5d66create action
Sets up a custom automated action for a specific webhook token.
019e5d66create global variable
Establishes a persistent variable that the agent can reference across different test sessions.
019e5d66create token
Generates and registers a new, unique webhook URL (token) for testing purposes.
019e5d66delete action
Removes a previously set custom action from a token's configuration.
019e5d66delete global variable
Deletes an environment-wide global variable, clearing the stored state.
019e5d66delete requests
Wipes out multiple captured webhook requests associated with a specific token ID.
019e5d66delete token
Permanently removes an entire webhook token and all its associated configurations.
019e5d66execute action
Runs a pre-configured custom action against the captured data of a specific request.
019e5d66get requests
Retrieves a list and details of all webhooks that have been sent to a given token.
019e5d66get token
Fetches the full configuration details for an existing webhook token.
019e5d66list actions
Lists all custom actions that are currently configured and active on a specific token.
019e5d66list global variables
Displays all environment-wide global variables, showing their names and current values.
019e5d66list tokens
Provides a directory listing of every webhook token currently managed by your account.
019e5d66set response
Manually sets the dynamic HTTP response (status code, headers, body) for one specific captured request.
019e5d66update action
Modifies an existing custom action attached to a webhook token.
019e5d66update global variable
Changes the value of a global variable, updating the shared state for subsequent tests.
019e5d66update token
Updates core settings on an existing webhook token, such as its alias or expiry time.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Webhook.site, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
What you can do with this MCP connector
Listen up. You need to test APIs and webhooks? Forget building local tunnels or writing boilerplate server code just for debugging. Webhook.site lets your AI agent handle all that right through the MCP Server. This thing gives you full control over inspecting, simulating, and automating complex HTTP interactions.
Token Management: Setting Up Your Test Environment
You start by getting an endpoint. You can call create_token to generate a brand new webhook URL—a unique token for your test. When you do that, you get control over the alias it uses and even set default response behaviors right when you make it. If you need to change those core settings later, use update_token.
For instance, if the endpoint expires too fast or its name is misleading, you modify those details with update_token.
You can see every token you've ever made by running list_tokens, which gives you a full directory listing of all active webhooks. If a test is done and you don't want the URL hanging around, use delete_token to permanently wipe out both the token and all its associated configurations.
Inspecting Traffic: What Happened?
When data hits your webhook, this server catches it for inspection. You call get_requests to pull a list of every single webhook that's been sent to a specific token ID; you get the full details on each one. This means you can read everything: raw headers, query parameters, and the entire payload body—you see exactly what your client sent over.
If you only want to wipe out the evidence after review, delete_requests clears all captured webhook requests associated with that token.
To make sure the data is clean for the next test cycle, you can manage state variables using global context. You use create_global_variable to establish a persistent variable that your agent needs to reference across multiple different testing sessions. If the environment gets messy, delete_global_variable clears out an environment-wide variable and its stored state.
You also control what data your agent sees by managing actions. You use list_actions to see all custom automation steps currently configured for a token. When you're ready to modify those rules, you call update_action, or if the setup is wrong, you run delete_action to remove it.
Simulation and State Control: Making It Behave
This isn't just reading data; you're actively controlling the conversation. You can force your webhook to behave like any API endpoint out there using set_response. This lets you manually set a dynamic HTTP response—you control the status code (like 401, 200, or 503), the headers, and even the body content for one specific captured request.
You validate client logic by simulating everything from complex API success to specific failures.
When an incoming request hits your token, you don't just inspect it; you automate a response using execute_action. This runs a pre-configured custom action against that request's history data, allowing for automated testing workflows based on the input. If you need to change the value of a shared context variable mid-test, you use update_global_variable to adjust the state for subsequent tests.
The Full Command Set
You can fetch the entire configuration details of an existing token with get_token. You'll see all available actions listed by running list_actions on a specific token. To manage your shared environment data, you check out all stored variables using list_global_variables.
This suite lets your agent build and test complex API interactions conversationally: generate endpoints with create_token, verify incoming payloads with get_requests, simulate failure modes with set_response, execute logic using execute_action, and maintain context across tests by controlling variables via create_global_variable or update_global_variable. You manage the entire lifecycle—from creation to deletion (delete_token)—without ever touching a command line.
How Webhook.site MCP Works
- 1 First, subscribe to the server and provide your Webhook.site API Key.
- 2 Then, ask your agent to perform an action, like creating a token using
create_tokenor checking recent data withget_requests. - 3 The agent runs the necessary tool calls against the service, retrieving real-time webhook data or setting up new endpoints for you.
The bottom line is that your AI client treats Webhook.site like a live API endpoint, letting you debug complex backend interactions without touching any local infrastructure.
Who Is Webhook.site MCP For?
Anyone who has to deal with third-party webhooks or APIs needs this. It's for the QA engineer who gets frustrated debugging a callback on stale staging environments, and for the backend dev who just wants to test an endpoint payload without running local tunnels. If you spend time clicking through multiple dashboards to find out what data was sent, you need this.
You use it to simulate various API failure modes and check if your service correctly processes payloads before connecting to a live staging environment.
You validate third-party callbacks against specific expected data structures, using set_response to force error conditions for testing resilience.
You monitor incoming webhook alerts and use tools like delete_requests or list_tokens to audit history and maintain clean development logs.
What Changes When You Connect
- Inspect every detail of an incoming webhook payload. Instead of just seeing success,
get_requestslets you examine raw headers, query params, and the full JSON body to pinpoint exactly where data is missing or malformed. - Control failure simulation with
set_response. You can't wait for a third party to fail; you force it. Set a specific status code (like 401 Unauthorized) or a custom error payload instantly to test your client's fallback logic. - Maintain session state easily using global variables. With
list_global_variablesandupdate_global_variable, your agent remembers context across multiple, unrelated webhook calls—critical for complex transaction testing. - Automate cleanup and auditing with built-in tools. If you run hundreds of tests, use
delete_requeststo clear old logs orlist_tokensto audit which endpoints are active, keeping your workspace clean. - Build multi-step workflows using actions. Instead of just receiving data, an incoming request can trigger a configured action via
execute_action, allowing you to test the entire operational flow in one go.
Real-World Use Cases
Debugging Failed Payment Callbacks
A payment provider sends a webhook, but your service fails on it. Instead of setting up complex local routes, you use create_token to get the endpoint URL. When the callback hits, you run get_requests via your agent to see the raw payload and headers that triggered the failure, allowing you to fix the issue immediately.
Testing Rate Limit Responses
You need to ensure your service handles a 429 Too Many Requests error gracefully. You use set_response on your token and manually force the status code to 429, along with required rate limit headers. Your agent then validates that your system correctly pauses or retries the request.
Auditing Old Integration Logs
A month of webhook traffic has filled up your test environment. You don't want to manually delete everything. You use delete_requests combined with a time constraint (e.g., older than 7 days) to clean the slate without losing critical recent data.
Chaining Webhook Events
A payment event needs to update a record, and then another service needs to be notified based on that success. You use create_action to define the subsequent notification step. When the initial webhook arrives, running execute_action triggers the entire chained workflow.
The Tradeoffs
Assuming persistence
The agent runs a test, gets data in the payload, and then assumes that data is available for the next prompt without explicit tools.
→
You must explicitly retrieve or store state. To access past payloads, use get_requests. If you need to pass information between separate webhook calls, save it first using create_global_variable.
Overwriting configuration
A developer manually changes a token's alias in the dashboard but forgets to update their agent’s prompt or use the correct tool.
→
Always manage tokens programmatically. Use update_token to modify settings like aliases or expiry times, ensuring your workflow is repeatable and auditable.
Missing data context
You run a complex test but forget which specific URL the payload came through, so you can't debug it.
→
Always use list_tokens first to confirm the exact token ID or alias. This ensures your subsequent debugging actions are tied to the correct endpoint.
When It Fits, When It Doesn't
Use this server if your primary need is debugging and testing external API communication. You should use it when you need a dedicated, zero-setup sandbox for webhooks—meaning you don't care about running continuous live traffic, just controlled test cases.
Don't use this if you are building a persistent, customer-facing backend that needs to handle millions of events per day; those require cloud infrastructure. Don't use it either if the problem is simple data transformation (e.g., changing a field name); in that case, a dedicated mapping tool is better.
The sweet spot is: Use this when you need temporary state (create_global_variable) combined with precise failure simulation (set_response) to validate complex business logic against real-world webhooks.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Webhook.site. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 17 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking webhook payloads usually means jumping between 4 different tabs.
Today, when a third party sends a webhook, you land on their dashboard. Then you have to copy the payload details into your local logger or monitoring tool. You check the headers in one spot and the body in another. If something goes wrong—a header is missing, or the status code wasn't 200—you waste time switching context just to compare what *should* be there versus what actually arrived.
With Webhook.site MCP Server, your agent handles it all. You tell it: 'Check the last request for token X.' It uses `get_requests` to pull up everything—headers, query params, and raw JSON payload—in one place. The context stays right in the chat window. You get immediate visibility without leaving your workflow.
Webhook.site MCP Server: Control API behavior instantly.
Manually testing a service often means you have to wait for someone else to break something, or you have to write dummy code just to simulate an error state (like a 503 Service Unavailable). This slows down the whole process and makes it hard to replicate specific failure paths.
This server lets your agent run `set_response` on any token. You can instantly force the system to respond with a 429 rate limit, or a 500 internal error body—all from chat. You control the test environment right down to the HTTP status code.
Common Questions About Webhook.site MCP
How do I check what data was sent to my webhook using get_requests? +
Call get_requests and provide the token ID. This tool fetches a list of all incoming webhooks, allowing you to review the raw payloads, headers, and query parameters for debugging.
What is the difference between create_token and update_token? +
create_token generates an entirely new webhook URL with fresh settings. update_token modifies the core attributes of an existing token, like changing its alias or expiry time.
Can I use Webhook.site MCP Server to simulate a specific API failure? +
Yes. Use set_response. This tool lets you manually set dynamic HTTP status codes (like 400 Bad Request) or custom error body content for testing client handling.
How do I keep data from one webhook test to the next? +
You need state management. Use create_global_variable to set a value, and then reference that variable in subsequent prompts or tools like update_global_variable.
What is the best way to manage and delete historical records using the `delete_requests` tool? +
Use delete_requests to purge recorded payloads. You provide the token ID and specify criteria like a date range or count. This clears your test history without affecting live webhook configurations.
Before running a complex test, how do I initialize necessary environment data using `create_global_variable`? +
You use create_global_variable to define initial state. Pass the variable name and value first. Your agent can then reference this stored context during subsequent API calls or actions.
If I need to perform multiple steps in a sequence, how does the `execute_action` tool work? +
The execute_action tool runs pre-configured tasks. You pass the specific request token and action ID. This allows your agent to trigger complex workflows based on incoming payload data.
What details does the `list_tokens` command provide about my existing webhook URLs? +
list_tokens gives you an overview of every active token ID linked to your account. It shows aliases and expiration dates, helping you quickly identify which endpoint needs debugging.
How can I create a temporary webhook URL that expires after one hour? +
Use the create_token tool and set the expiry parameter to 3600 seconds. You can also add an alias to make the URL easier to identify.
Can I see the headers and body of the requests sent to my webhook? +
Yes! Use the get_requests tool with your Token ID. It will return a list of captured requests including full headers, query strings, and the raw payload content.
Is it possible to make the webhook return a specific JSON response? +
Absolutely. Use the set_response tool to define a custom content (base64 encoded), status code, and JSON headers for any specific request received by your token.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
Mistral AI
Build with European open-weight language models that deliver strong reasoning, multilingual capability, and efficient inference.
Resend Alternative
Send emails and manage domains via Resend — send transactional emails, track deliveries, manage domains and API keys from any AI agent.
AI21 Studio
Unlock AI21's Jamba models and language tools for summarizing, paraphrasing, and grammar correction natively.
You might also like
Robly
Automate email marketing via Robly — manage contacts, subscriber lists, and campaign stats with AI.
IP & CIDR Validator
Equip cybersecurity agents with binary IP math. Instantly validate IPv4/IPv6 addresses and check CIDR subnet allocations local.
CellarPass
Manage winery tasting room reservations, experiences, availability, venues, and guest history for your CellarPass account through natural conversation.