# Opplevagent MCP Server

MCP server for **[Opplevagent](https://opplevagent.no)** — discover Norwegian experiences and activities from Claude Desktop, Cursor, or any MCP client.

Search tours, courses and things to do across Norway and filter by **county, municipality, category, weather, season, group size, age and price**. Every result links straight to a booking page.

[![npm](https://img.shields.io/npm/v/opplevagent-mcp)](https://www.npmjs.com/package/opplevagent-mcp)

## Install

### Claude Desktop

Add to `~/.claude/claude_desktop_config.json` (macOS/Linux) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows):

```json
{
  "mcpServers": {
    "opplevagent": {
      "command": "npx",
      "args": ["opplevagent-mcp"]
    }
  }
}
```

Restart Claude Desktop. No API key required.

### Run directly

```bash
npx opplevagent-mcp
```

## Tools

| Tool | Description |
|------|-------------|
| `opplev_discover` | Search experiences by structured filters: `fylke` (county), `kommune` (municipality), `category`, `indoor_outdoor`, `weather`, `season`, `group_size`, `age`, `max_price`, `duration_max`, `language`, `limit`. Returns ranked experiences with place, category, duration, price and a booking link. |
| `opplev_info` | Get the full profile for one experience by `id` (UUID) — description, place, season, duration, group size, age suitability, price, languages, accessibility, meeting point and booking link. |
| `opplev_categories` | List all experience categories with the count of published experiences in each. |

All tools are **read-only** and query the public Opplevagent API. No authentication.

## Example prompts

- *"Hva kan vi finne på i Oslo når det regner?"*
- *"Hvalsafari i Tromsø"*
- *"Familievennlige aktiviteter utendørs i Bergen om sommeren"*
- *"Things to do in Trondheim under 500 kr"*

## Categories

`kultur_historie` · `sightseeing_transport` · `adrenalin_action` · `dyreliv_safari` · `vinter_sno` · `natur_friluft` · `overnatting_opplevelse` · `velvaere_spa` · `mat_drikke`

## Configuration

| Env var | Default | Purpose |
|---------|---------|---------|
| `OPPLEVAGENT_URL` | `https://opplevagent.no` | Base URL of the Opplevagent API. Override to point at a staging instance. |

## How it works

Opplevagent is an **A2A (Agent-to-Agent) marketplace** for Norwegian experiences. This MCP server is a thin, read-only wrapper over the public discovery API:

- REST: `https://opplevagent.no/api/opplevelser`
- Discover: `https://opplevagent.no/api/opplevelser/discover`
- Agent card: `https://opplevagent.no/.well-known/agent-card.json`
- OpenAPI: `https://opplevagent.no/openapi.json`
- Remote MCP (Streamable HTTP): `https://opplevagent.no/mcp`

## Links

- Website: <https://opplevagent.no>
- npm: <https://www.npmjs.com/package/opplevagent-mcp>
- Issues: <https://github.com/slookisen/opplevagent-mcp/issues>

## License

MIT © Daniel Fredriksen