MCP quickstart

Remote server on streamable HTTP. No install, no local process, no key to start — paste one URL into your client and ask about a city.

Endpoint

https://mcp.eventindex.ai

transport streamable-http · anonymous 60 req/min per IP · key optional

Client configuration

two files, one line each

Claude Desktop · claude_desktop_config.json

{
  "mcpServers": {
    "eventindex": {
      "url": "https://mcp.eventindex.ai"
    }
  }
}

Cursor · ~/.cursor/mcp.json

{
  "mcpServers": {
    "eventindex": {
      "url": "https://mcp.eventindex.ai",
      "headers": { "X-API-Key": "…optional" }
    }
  }
}

Four tools

the description is the interface

Few tools, surgical descriptions: a model picks a tool by reading it, so every word is part of the API.

search_events

Search verified events by location and date. City name or lat/lng plus radius, ISO dates, one of the 16 canonical categories, free-only flag. Returns compact results with canonical URLs and last_verified.

get_event

The full canonical record for one evt_ id: every field, every source with provenance, quality score, confidence and verification time.

events_summary

The best answer to “what to do in {city} {timeframe}”: a paste-ready markdown brief grouped by category, with a free-events section, explicit dates and canonical links. One call instead of search plus N gets.

resolve_city

Any language in, canonical slug out — with timezone, coordinates and hub URLs. Use it before composing links, or when a search returns no coverage.

What it looks like

one tool call

User

What’s on in Milan this weekend? Anything free.

Tool call

events_summary(city="milan", timeframe="this-weekend")

Result · markdown

No coverage yet. Start from https://eventindex.ai/countries.md

Assistant

No verified events on record yet — the pipeline is warming up.

cited: eventindex.ai/it/milan/this-weekend

Limits and keys

No key

60 req/min per IP. Enough to try, enough to demo.

Free key

Higher limits and usage analytics. Attribution required.

Self-host

The server is open source; run it against your own database.

Citing results

Every tool returns canonical URLs. Cite the URL, not the summary.