`events`

Pack: idf-events · Endpoint: https://gateway.pipeworx.io/idf-events/mcp

Find upcoming events across the Île-de-France / Greater Paris region (Paris + suburbs). Filter by keyword, city/commune, free admission, and date window. Returns events sorted by start date. Titles/descriptions are in French.

Parameters

Name	Type	Required	Description
`query`	string	no	Keyword (full-text), e.g. “concert”, “exposition”, “théâtre”.
`city`	string	no	Filter to one commune, e.g. “Paris”, “Versailles”, “Saint-Denis”.
`free_only`	boolean	no	If true, best-effort free events (conditions mention “gratuit”).
`from`	string	no	Include events on/after this date YYYY-MM-DD (default: today).
`to`	string	no	Include events starting on/before this date YYYY-MM-DD.
`limit`	number	no	Max events (1-${MAX_LIMIT}, default 20).
`offset`	number	no	Pagination offset (default 0).

Example call

Arguments

{
  "query": "concert",
  "_apiKey": "your-idf-events-api-key"
}

curl

curl -X POST https://gateway.pipeworx.io/idf-events/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"events","arguments":{"query":"concert","_apiKey":"your-idf-events-api-key"}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('events', {
  "query": "concert",
  "_apiKey": "your-idf-events-api-key"
});

More examples

{
  "query": "exposition",
  "city": "Paris",
  "free_only": true,
  "from": "2025-01-15",
  "to": "2025-02-28",
  "limit": 10,
  "_apiKey": "your-idf-events-api-key"
}

Connect

Add this to your MCP client config, or use one-click install buttons:

{
  "mcpServers": {
    "idf-events": {
      "url": "https://gateway.pipeworx.io/idf-events/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

events