Use Insomnia MCP clients to test aggregated MCP tools

Uses: Insomnia AI Gateway deck

Prerequisites

Insomnia

Download and install Insomnia.

AI Gateway running

This is a Konnect tutorial and requires a Konnect personal access token.

Create a new personal access token by opening the Konnect PAT page and selecting Generate Token.
Export your token to an environment variable:
```
export KONNECT_TOKEN='YOUR_KONNECT_PAT'
```
Copied!
Run the AI Gateway quickstart script to automatically provision a control plane and data plane in Kong Konnect, and configure your environment:
curl -Ls https://get.konghq.com/ai | bash -s -- -k $KONNECT_TOKEN
Copied!

This sets up a AI Gateway control plane named ai-quickstart, provisions a local data plane, and prints out the following environment variables export:

export AI_GATEWAY_ID=your-gateway-id
export KONNECT_TOKEN=$KONNECT_TOKEN
export KONNECT_CONTROL_PLANE_NAME=ai-quickstart
export KONNECT_CONTROL_PLANE_URL=https://us.api.konghq.com
export KONNECT_PROXY_URL='http://localhost:8000'

Copied!

Copy and paste these into your terminal to configure your session.

decK v1.66.0+

To complete this tutorial, install decK. We recommend keeping decK up to date with the latest version (1.66.0).

decK is a CLI tool for managing Kong Gateway declaratively with state files. This guide uses deck gateway apply, which directly applies entity configuration to your Gateway instance.

You can check your current decK version with deck version.

Aggregated MCP server

Before testing with Insomnia, complete the Aggregate MCP tools from multiple AI MCP Proxy plugins guide.
That guide produces:

Multiple conversion-only AI MCP Proxy plugin instances that each expose MCP tools
One listener-mode AI MCP Proxy plugin aggregating those tools by tag
A public listener endpoint:
```
http://localhost:8000/mcp-aggregation 
```
Copied!

Network access

Ensure your local machine can reach the listener endpoint produced during aggregation.

Test connectivity:

curl -s -X POST http://localhost:8000/mcp-aggregation \
-H 'Content-Type: application/json' \
-H 'Accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-06-18","capabilities":{},"clientInfo":{"name":"curl","version":"1.0"}}}'

Copied!

Use Insomnia to connect to an MCP server exposed through the AI MCP Proxy plugin in listener mode.

This listener server aggregates MCP tools from multiple upstream APIs, enabling you to validate end-to-end behaviour using Insomnia’s Params, Headers, Events, and Console panels.

After completing the aggregation workflow described in Aggregate MCP tools from multiple AI MCP Proxy plugins and exposing an autogenerated or aggregated MCP server, follow this guide to test and validate its MCP tools using Insomnia’s MCP Clients.

Create an MCP client

Open Insomnia.
In the sidebar, click MCP Clients.
Click New MCP Client.
In the Name field, enter a name: Aggregated MCP Tools
Click Create.
In the MCP Server URL field, select the HTTP method, and enter your listener URL: http://localhost:8000/mcp-aggregation
Click Connect.

Insomnia connects to the MCP server and discovers all of the aggregated tools:

draw-cards
get-orders-for-user
get-users
shuffle-and-draw
shuffle-cards
weather-internet

Validate tools

In the sidebar, locate the Tools drop-down section.
Review the list of available tools.

If any tools are missing: Confirm that the listener Route is active and reachable.

Test tools

Use Insomnia’s testing panels to validate MCP tool behaviour:

In Tools, click any tool, for example: get-orders-for-user.
In the request pane, click the Params tab.
Enter the required parameter value, for example query_userid: ord002
Click Call Tool.
In the response pane, click the Console tab.

A successful response confirms that your aggregated MCP configuration is working correctly.