MCP Echo Service
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MCP Echo Service echo back 'Hello, world!' in uppercase"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Echo MCP Server
A Model Context Protocol (MCP) server that echoes messages, delays, and structured JSON data. Useful for testing MCP client integrations, verifying protocol connectivity, and validating tool call behavior.
View on mpak registry | Built by NimbleBrain
Install
Install with mpak:
mpak install @nimblebraininc/echoClaude Code
claude mcp add echo -- mpak run @nimblebraininc/echoClaude Desktop
Add to your claude_desktop_config.json:
{
"mcpServers": {
"echo": {
"command": "mpak",
"args": ["run", "@nimblebraininc/echo"]
}
}
}See the mpak registry page for full install options.
Related MCP server: Multiple MCP Servers Framework
Tools
echo_message
Echo back a message with optional uppercase formatting.
Parameter | Type | Required | Description |
|
| Yes | The message to echo back |
|
| No | Convert the message to uppercase (default: |
Example call:
{
"name": "echo_message",
"arguments": {
"message": "Hello Echo!",
"uppercase": true
}
}Example response:
{
"original_message": "Hello Echo!",
"echoed_message": "HELLO ECHO!",
"uppercase_applied": true,
"message_length": 11,
"timestamp": "2025-01-15T12:00:00+00:00"
}echo_with_delay
Echo back a message after a simulated delay. Useful for testing timeout handling and async behavior.
Parameter | Type | Required | Description |
|
| Yes | The message to echo back |
|
| No | Delay in seconds, max 5.0 (default: |
Example call:
{
"name": "echo_with_delay",
"arguments": {
"message": "Delayed echo",
"delay_seconds": 2.0
}
}Example response:
{
"original_message": "Delayed echo",
"echoed_message": "Delayed echo",
"requested_delay": 2.0,
"actual_delay": 2.001,
"start_time": "2025-01-15T12:00:00+00:00",
"end_time": "2025-01-15T12:00:02+00:00",
"timestamp": "2025-01-15T12:00:02+00:00"
}echo_json
Echo back structured JSON data with validation and analysis.
Parameter | Type | Required | Description |
|
| Yes | JSON object to echo back |
Example call:
{
"name": "echo_json",
"arguments": {
"data": {
"name": "test",
"count": 42,
"active": true
}
}
}Example response:
{
"original_data": {"name": "test", "count": 42, "active": true},
"echoed_data": {"name": "test", "count": 42, "active": true},
"analysis": {
"key_count": 3,
"keys": ["name", "count", "active"],
"data_types": {"name": "str", "count": "int", "active": "bool"},
"total_size": 42
},
"timestamp": "2025-01-15T12:00:00+00:00"
}Quick Start
Local Development
git clone https://github.com/NimbleBrainInc/mcp-echo.git
cd mcp-echo
# Install dependencies
uv sync
# Run the server (stdio mode)
uv run python -m mcp_echo.server
# Or run via FastMCP
uv run fastmcp run src/mcp_echo/server.pyThe server supports HTTP transport with:
Health check:
GET /healthMCP endpoint:
POST /mcp
Development
# Install with dev dependencies
uv sync --group dev
# Run unit tests
make test
# Run with coverage
make test-cov
# Run all checks (format, lint, typecheck, unit tests)
make check
# Format
uv run ruff format .
# Lint
uv run ruff check .E2E Tests
End-to-end tests validate the full MCPB bundle lifecycle: building the bundle, deploying it into a Docker container, and calling tools over HTTP.
Prerequisites: Docker running, mcpb CLI installed (npm install -g @anthropic-ai/mcpb)
make test-e2eThe tests:
Vendor dependencies for the Docker container's Linux architecture
Build a
.mcpbbundle withmcpb packServe the bundle over HTTP
Start a
nimbletools/mcpb-pythoncontainer that downloads and runs the bundleVerify the
/healthendpoint, MCP tool listing, and tool invocation via streamable HTTP
About
Echo MCP Server is published on the mpak registry and built by NimbleBrain. mpak is an open registry for Model Context Protocol servers.
License
MIT
Available Tools
3 toolsecho_jsonEcho JsonC
Echo back structured JSON data with validation and analysis.
Inputs: data (required). Returns: Response model for echo_json tool.
echo_messageEcho MessageB
Echo back a message with optional formatting.
Inputs: message (required), uppercase. Returns: Response model for echo_message tool.
echo_with_delayEcho With DelayB
Echo back a message after a simulated delay.
Inputs: message (required), delay_seconds. Returns: Response model for echo_with_delay tool.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool targets a distinct echo behavior: plain message echo, delayed echo, and structured JSON echo with validation. The only soft overlap is that echo_with_delay is essentially echo_message plus a timing parameter, which could lead an agent to pick either for a simple delayed echo.
All three tools share a clear 'echo_' prefix with a predictable suffix, giving a coherent family (echo_message, echo_with_delay, echo_json). The 'with_' connector in echo_with_delay is a minor stylistic deviation from the noun-suffix pattern but remains readable.
Three tools is well within a sensible range for a small echo/diagnostic service and each covers a genuinely different output mode. The set is slightly thin, and the delay variant arguably could be a parameter rather than its own tool.
The domain is echoing, and the surface covers plain text, delayed responses, and validated/analyzed JSON, which handles the obvious use cases without dead ends. Minor gaps (e.g., no explicit bulk or formatting-only operation) are workable through the optional formatting on echo_message.
Maintenance
Related MCP Connectors
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
MCP compatibility and transport verification server.
Related MCP Servers
- FlicenseNot gradedqualityDmaintenanceA simple demonstration MCP server that provides an echo tool and resource for learning how to build MCP servers. Serves as a starting point and template for creating custom MCP server implementations.1-
- AlicenseCqualityDmaintenanceProvides a framework for running multiple MCP servers using FastAPI, stdio, and streamable-http transports, with an echo tool for testing and integration with MCP Inspector.14MIT
- AlicenseAqualityDmaintenanceAn MCP server that provides echo resource, tool, and prompt functionality for testing and demonstration.917 npm1MIT
- AlicenseNot gradedqualityDmaintenanceProvides basic tools for testing MCP functionality: echo, greet, and calculate.8 npmISC