mcp-smokeSmoke-test MCP servers in plain English

A small CLI that sends real requests through your MCP server's tool path, and checks the surrounding infrastructure along the way.

Plain-English requests

Say "add 41 and 1". A model reads your server's tool list and decides which MCP tool to call.

Agent mode

Point it at a Streamable HTTP URL or launch a stdio command. One client for both.

Server specs

Skip the model. Initialize, list tools, prompts and resources, and optionally call them, with a JSON report.

Smoke mode

One realistic client for end-to-end tests of routing, auth, logging, tracing and analytics.

Harnesses and CI

Bring either provider key through the environment or a .env file.

Provider config

A small MCP server with tools, prompts and a resource ships in the repository for trying things out.

Test server