Find agent skills by outcome

- Store API keys in environment variables

never in code

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

### Markdown Format (`response_format=markdown`

typically default)

- Use headers

lists

- Provide tool annotations (readOnlyHint

destructiveHint

Creative

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

list

1. Use snake_case: `search_users`

`create_project`

- Examples: `slack-mcp-server`

`github-mcp-server`

The name should be general

descriptive of the service being integrated

- Examples: `slack_mcp`

`github_mcp`

- Streamable HTTP: For remote servers

multi-client scenarios

- Return `has_more`

`next_offset`

- stdio: For local integrations

command-line tools

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

`slack-mcp-server`)

Coding & Debugging

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

`slack_mcp`)

- Example: `slack_send_message`

`github_create_issue`

Creative

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

then fetch specific pages with `.md` suffix

- Verifiable: Single

clear answer that can be verified by string comparison

3. Question Generation: Create 10 complex

realistic questions

After implementing your MCP server

create comprehensive evaluations to test its effectiveness.