# mcp-opentripmap

MCP server for points of interest discovery via the [OpenTripMap API](https://opentripmap.io).
Find tourist attractions, landmarks, and places of interest near any location worldwide.

> **Status: Work in Progress** — Server scaffolding is in place. Tools are not yet implemented.

---

## Prerequisites

- [Bun](https://bun.sh) runtime (`curl -fsSL https://bun.sh/install | bash`)
- An [OpenTripMap API key](https://opentripmap.io/product) — free tier available

---

## Planned Tools

- `otm_search_places` — Search for places of interest near a location by name or category
- `otm_get_place_details` — Get detailed information about a specific place (description, Wikipedia excerpt, photos)
- `otm_list_categories` — List available place categories (museums, natural, architecture, etc.)

---

## Data Source

[OpenTripMap](https://opentripmap.io) aggregates POI data from OpenStreetMap, Wikipedia,
and Wikidata. Covers 3M+ places worldwide. Free tier: 1,000 requests/day.

---

## Install

```bash
git clone git@github.com:McCullonas/mcp-opentripmap.git
cd mcp-opentripmap
bun install
```

---

## MCP Client Configuration (once implemented)

```json
{
  "mcpServers": {
    "opentripmap": {
      "command": "bun",
      "args": ["run", "/path/to/mcp-opentripmap/src/index.ts"],
      "env": {
        "OPENTRIPMAP_API_KEY": "your-key-here"
      }
    }
  }
}
```

---

## Licence

MIT