Skip to main content

​
Overview

The Evento public MCP server runs locally over stdio and maps tool calls to authenticated public Evento API routes.

Local stdio transport

Runs on your machine with no hosted MCP layer.

Public API tools

Includes list-events and get-event.

Central auth injection

Injects your API key for every outbound request.

Client-agnostic

Works with Claude Desktop, Cursor, ChatGPT-compatible MCP clients, and others.

​
Requirements

  • Node.js 18+
  • npm
  • Evento developer API key
  • Any MCP client that supports stdio

​
Install and run

git clone https://github.com/andreneves/evento-public-mcp.git
cd evento-public-mcp
npm install
npm run build
cp .env.example .env
Set PUBLIC_API_KEY in .env, then run: 
npm start

​
Minimal environment variables

Required:
  • PUBLIC_API_KEY
Optional:
  • EVENTO_API_BASE_URL
  • EVENTO_API_TIMEOUT_MS
  • EVENTO_API_RETRY_ATTEMPTS
  • EVENTO_API_RETRY_DELAY_MS
  • EVENTO_PUBLIC_API_KEY (legacy fallback)
  • EVENTO_SMOKE_USERNAME

​
Next steps

Client configuration

Configure Claude Desktop, Cursor, and other MCP clients.

Available tools

See tool inputs and API route mappings.

Architecture

Review runtime flow and file responsibilities.

Testing and troubleshooting

Verify setup and debug common failures.