Test with MCP Inspector

This step is optional. You can skip straight to running the chat gateway; the Inspector is just the fastest way to check that the server and its tools work, with no AI involved.

MCP Inspector is the official debugging UI for MCP servers. It lets you browse tools and call them by hand, with no AI model in the loop, and check that a tool does what you think it does.

With the server running in HTTP mode (see run the MCP server):

npx @modelcontextprotocol/inspector

Then, in the Inspector web page that opens:

1. Choose transport type Streamable HTTP.
2. Connect to http://127.0.0.1:8063 (note: no /mcp suffix).
3. List the tools, pick one, fill its parameters and run it.

You can also let the Inspector launch the server itself over stdio:

npx @modelcontextprotocol/inspector uv run mcp-server

Tip

When a tool you expected does not appear in the list, check the server logs at startup: tools that do not follow the result contract are skipped with a warning, not an error.