Find agent skills by outcome

- Timestamps and datetimes (months

days

- Use synonyms

related concepts

- May elicit tools returning large JSON objects or lists

overwhelming the LLM

- Require multiple searches

analyzing multiple related items

- Complex

requiring potentially dozens of tool calls or steps

3. Questions must be REALISTIC

CLEAR

- Answerable with a single

verifiable value that you identify in advance

PromptBeginner5 minmarkdownQuality: 26

The measure of quality of an MCP server is NOT how well or comprehensively the server implements too...

but how well these implementations (input/output schemas

Create 10 human-readable questions requiring ONLY READ-ONLY

INDEPENDENT

- Answers must be single

verifiable values

PromptBeginner5 minmarkdownQuality: 26

This document provides guidance on creating comprehensive evaluations for MCP servers. Evaluations t...

complex questions using only the tools provided.

- Questions must be READ-ONLY

INDEPENDENT

- Performance testing: Check behavior under load

timeouts

Writing & Content

return { content: [{ type: text

text: result }] };

- Security testing: Validate auth

input sanitization

- Provide helpful

specific error messages with suggested next steps

Coding & Debugging

- Store API keys in environment variables

never in code

PromptBeginner5 minmarkdownQuality: 26

Important: Annotations are hints

not security guarantees. Clients should not make security-critical decisions based solely on annotations.

- Single-user

single-session scenarios

Best for: Remote servers

web services

- Simple setup

no network configuration needed

Best for: Local integrations

command-line tools

Data

- Return pagination metadata: Include has_more

nextoffset/nextcursor

Markdown Format (response_format=markdown

typically default)