# fyndling

# fyndling-mcp

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y smithery mcp add ralf/fyndling

# Browse available tools
npx -y smithery tool list ralf/fyndling

# Get full schema for a tool
npx -y smithery tool get ralf/fyndling find_events_near

# Call a tool
npx -y smithery tool call ralf/fyndling find_events_near '{}'
```

## Direct MCP Connection

Endpoint: `https://fyndling--ralf.run.tools`

## Tools (8)

- `find_events_near` — Find medieval events near a geographic location. Returns events sorted by distance.
- `list_events` — List medieval events filtered by category, country, and/or date range.
- `get_event` — Get full details for a single event by its ID.
- `search_recipes` — Search historical recipes (13th–17th century) by course, difficulty, and other criteria.
- `get_recipe` — Get the full details of a single recipe including ingredients, annotations, FAQ, and original transcript.
- `compose_menu` — Compose a multi-course menu from historical recipes. Minimizes ingredient overlap between courses. Returns one recipe p…
- `list_recipe_sources` — List all available historical recipe sources with their year, region, language, and recipe count.
- `find_pois_near` — Find permanent medieval-themed locations (meaderies, castles, restaurants) near a geographic point.

```bash
# Get full input/output schema for a tool
npx -y smithery tool get ralf/fyndling <tool-name>
```