Event MCP Server

The Model Context Protocol (MCP) allows AI models to interact with external tools and data. GlobalEventBase provides an MCP server implementation that lets you connect our event data directly to your favorite AI assistants (like Claude Desktop).

Features

Search Events: Allow the AI to search for events by country and category.
Get Event Details: Retrieve detailed information about specific events.
Geocoding: The AI can use our location resolution to understand vague location queries.

Installation

You can run the GlobalEventBase MCP server using npx.

Prerequisites

Ensure you have Node.js installed on your machine.

Configuration (Claude Desktop)

To add GlobalEventBase to Claude Desktop, edit your configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

Add the following configuration:

{
  "mcpServers": {
    "global-event-base": {
      "command": "npx",
      "args": [
        "-y",
        "globaleventbase-mcp"
      ]
    }
  }
}

Restart Claude

Restart the Claude Desktop application. You should now see the global-event-base tools available.

Available Tools

The MCP server exposes the following tools to the AI:

`search_events`

Searches for events based on criteria.

Arguments:
- country (string, optional): ISO2 country code (e.g., "US").
- category (string, optional): Event category.
- limit (number, optional): Max number of results.

`get_event`

Retrieves details for a specific event.

Arguments:
- id (string, required): The event ID.

Example Prompts

Once configured, you can ask Claude questions like:

"What tech conferences are happening in Japan next month?"
"Find me music festivals in the UK."
"Tell me more about the event with ID 12345."

On this page