Agent skill

Test a Live MCP Endpoint

MCP Server Tester is a free, MIT-licensed agent skill that probes a live MCP endpoint before you attach it to an AIML.chat agent — verifying the handshake, listing the tools, checking auth, and confirming which tools are marked mutating. Catch a broken or over-permissive server before it reaches a conversation.

MCP Server Tester is a free, MIT-licensed agent skill that probes a live MCP endpoint before you attach it to an AIML.chat agent — verifying the handshake, listing the tools, checking auth, and confirming which tools are marked mutating. Catch a broken or over-permissive server before it reaches a conversation.

What it does

The skill connects to an MCP endpoint and runs a health check: it completes the protocol handshake, lists the tools the server exposes with their input schemas, verifies your auth (none, bearer, or custom header) actually works, and reports which tools are mutating so you know what will require write-confirm. It flags common problems — an unreachable URL, a failing token, a tool that should be marked mutating but isn't — so you fix them before the agent calls them live. The output is a short readiness report you can act on.

The skill

name: mcp-server-tester
Use before attaching an MCP server to an AIML.chat agent.

Steps:
1. Take the MCP endpoint URL and auth (none/bearer/custom header).
2. Complete the handshake and list tools with their input schemas.
3. Verify auth works and flag any mutating tool not marked as such.
4. Output a readiness report: reachable, authed, tools, write-safety.

How to use it

Copy the SKILL.md into your agent framework's skills folder and run it against any endpoint, or use AIML.chat's built-in test when installing a server. It pairs with the MCP server scaffolder for servers you build and the MCP auth setup skill for credentials. The custom MCP integration explains connecting your own server.

Ready to wire one up? Start free, test your endpoint, and attach it with confidence — see pricing for limits.

What does it check?+

The handshake, the tool list and schemas, that auth works, and which tools are mutating — a full readiness report.

Does it run write actions during the test?+

No — it inspects the tool list and metadata; it doesn't execute mutating tools while testing.

Is the skill free?+

Yes — it is MIT-licensed and free to copy. Using MCP in AIML.chat counts toward your plan's limits; see pricing.

Add AI chat to your site

Free plan · No credit card · 5 minutes