Find agent skills by outcome

return { content: [{ type: text

text: result }] };

Important: Annotations are hints

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

Coding & Debugging

- Store API keys in environment variables

never in code

- Single-user

single-session scenarios

Best for: Remote servers

web services

- Simple setup

no network configuration needed

Best for: Local integrations

command-line tools

### Markdown Format (`response_format=markdown`

typically default)

Data

- Return pagination metadata: Include `has_more`

`next_offset`/`next_cursor`

- Use headers

lists

- Provide tool annotations (readOnlyHint

destructiveHint

1. Use snake_case: `search_users`

`create_project`

The name should be general

descriptive of the service being integrated

- Examples: `slack-mcp-server`

`github-mcp-server`

- Examples: `slack_mcp`

`github_mcp`

- stdio: For local integrations

command-line tools

- Streamable HTTP: For remote servers

multi-client scenarios

- Return `has_more`

`next_offset`

- Example: `slack_send_message`

`github_create_issue`

- Node/TypeScript: `{service}-mcp-server` (e.g.

`slack-mcp-server`)

Coding & Debugging

- Python: `{service}_mcp` (e.g.

`slack_mcp`)

3. Question Generation: Create 10 complex

realistic questions

- Verifiable: Single

clear answer that can be verified by string comparison

To create effective evaluations

follow the process outlined in the evaluation guide: