# Shir-man MCP Endpoint

`/mcp` is a small, read-only Model Context Protocol endpoint for discovering hosted tools, preset deep links, and agent endpoints on this site.

## Transport

- Endpoint: `/mcp`
- Transport: Streamable HTTP
- Protocol version: `2025-03-26`

## Tools

### `search_site_tools`

Search hosted tools on `shir-man.com` and return matching URLs.

Arguments:

- `query` (string, required)
- `limit` (integer, optional)

### `get_site_tool`

Return one hosted tool or preset deep link by its stable discovery id.

Arguments:

- `tool_id` (string, required)

### `search_text_processor_presets`

Search Text Processing Toolkit presets and return deep links that open a specific preset.

Arguments:

- `query` (string, required)
- `limit` (integer, optional)

### `get_text_processor_preset`

Return one Text Processing Toolkit preset by preset id.

Arguments:

- `preset_id` (string, required)

### `list_agent_endpoints`

Return machine-readable discovery endpoints published by the site.

Arguments:

- none

## Related endpoints

- Server card: `/.well-known/mcp/server-card.json`
- API catalog: `/.well-known/api-catalog`
- Status: `/api/status/mcp`

## Text processor deep links

Text Processing Toolkit presets can be opened directly with:

- `/text-processor/?preset=humanize-chatgpt`
- `/text-processor/?preset=format-to-markdown`
- `/text-processor/?preset=html-to-markdown`