Find agent skills by outcome

return { content: [{ type: text

text: result }] };

- Security testing: Validate auth

input sanitization

Coding & Debugging

- Store API keys in environment variables

never in code

- Single-user

single-session scenarios

Important: Annotations are hints

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

- Simple setup

no network configuration needed

Best for: Local integrations

command-line tools

Best for: Remote servers

web services

- Use headers

lists

### Markdown Format (`response_format=markdown`

typically default)

Data

- Return pagination metadata: Include `has_more`

`next_offset`/`next_cursor`

- Provide tool annotations (readOnlyHint

destructiveHint

Creative

3. Be action-oriented: Start with verbs (get

list

1. Use snake_case: `search_users`

`create_project`

The name should be general

descriptive of the service being integrated

- Examples: `slack_mcp`

`github_mcp`

- Examples: `slack-mcp-server`

`github-mcp-server`

- Return `has_more`

`next_offset`

- stdio: For local integrations

command-line tools

- Streamable HTTP: For remote servers

multi-client scenarios

- 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`)

Creative

- MCP Protocol: Start with sitemap at `https://modelcontextprotocol.io/sitemap.xml`

then fetch specific pages with `.md` suffix