mcp-tester

Test MCP server connectivity and tool execution across stdio, http, and sse transports.

Updated Dec 22, 2025
One-click install
npx skills add https://github.com/rwxproject/agent-framework --skill mcp-tester
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: mcp-tester
Source: https://github.com/rwxproject/agent-framework/tree/main/.claude/skills/mcp-tester
Command: npx skills add https://github.com/rwxproject/agent-framework --skill mcp-tester

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you test and debug MCP (Model Context Protocol) server connections, tool discovery, and tool execution across stdio, http, and sse transports.

Core Features & Use Cases

  • Connection Test: Verify the MCP server is reachable and initializes correctly (stdio, http, or sse).
  • Tool Discovery: List available tools from a connected MCP server.
  • Tool Execution: Execute a specific tool and inspect results.
  • Use Case: When adding a new MCP server, use this Skill to validate connectivity and tool availability before integration.

Quick Start

Run a basic MCP test against your server and observe available tools and health status.

Frequently Asked Questions about mcp-tester

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I test MCP server connectivity across different transports?

Test MCP server connectivity by verifying the server initializes correctly over stdio, http, or sse transports. This Skill validates that your MCP server is reachable and responds to JSON-RPC initialization requests before tool execution.

Can I discover and list tools available from an MCP server?

Yes. Tool discovery lists all available tools exposed by a connected MCP server, showing their names, descriptions, and input schemas. This step is essential when adding a new MCP server to verify integration before deployment.

How do I execute and debug a specific tool on an MCP server?

Execute a tool by sending it to the connected MCP server and inspect the results and error handling. This Skill captures tool execution responses, environment variable expansion, and JSON-RPC interactions for debugging tool behavior.

What should I validate when adding a new MCP server?

Validate .mcp.json configuration, server connectivity, tool availability across your transport type, and health/debugging endpoints. This Skill automates these checks to catch integration issues before the server enters production.

Does this work with stdio, HTTP, and SSE transports?

Yes. This Skill supports testing MCP servers across all three transports—stdio, http, and sse—so you can verify connectivity and tool execution regardless of how your server communicates.

How do I troubleshoot MCP tool execution failures?

Test tool execution with error handling inspection, environment variable expansion, and JSON-RPC response analysis. This reveals whether failures stem from configuration, connectivity, or tool logic.