events
Search source-verified events (sports, festivals, school holidays) and create progress pages.
Should I use this
Quality & Safety
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"events": {
"url": "https://eventcompletion.com/mcp"
}
}
}Remote endpoints
https://eventcompletion.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢search_events(query, status, category, language, limit)
Search EventCompletion's curated events by words in the name or description (every word must match, any order), optionally filtered by status, category and language. Returns dates, progress, location and the page URL.
Input Schema
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Words to look for, e.g. \"fiba world cup\" or \"vacances zone b\"."
},
"status": {
"type": "string",
"enum": [
"ongoing",
"upcoming",
"completed",
"all"
],
"description": "Default: all."
},
"category": {
"type": "string",
"description": "e.g. sport, culture, trade-show, tech, school, politics, institutions, civic, music, market, tv-film."
},
"language": {
"type": "string",
"enum": [
"fr",
"en"
],
"description": "Language of the event page."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25,
"description": "Default 10."
}
}
}🟢upcoming_events(within_days, category, language, limit)
Events that start soonest (curated catalogue). Use it for "what is coming up?" questions.
Input Schema
{
"type": "object",
"properties": {
"within_days": {
"type": "integer",
"minimum": 1,
"maximum": 730,
"description": "Only events starting within this many days. Default 90."
},
"category": {
"type": "string"
},
"language": {
"type": "string",
"enum": [
"fr",
"en"
]
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 25
}
}
}🟢get_event(slug)
Details of one event by slug (the last part of its URL), including progress right now and where its dates were verified.
Input Schema
{
"type": "object",
"properties": {
"slug": {
"type": "string",
"description": "e.g. \"wimbledon-2027\"."
}
},
"required": [
"slug"
]
}🟡register_agent(name, contact_email)
Issue an API key for your agent (shown once, keep it). Send it as "Authorization: Bearer <key>" on later requests for higher rate limits. Give a contact_email to be able to create events: a confirmation link is sent to it.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 60,
"description": "Name of your agent or client, e.g. \"Acme research assistant\"."
},
"contact_email": {
"type": "string",
"description": "Optional but required to create events. A human must confirm it."
}
},
"required": [
"name"
]
}🟡create_event(name, start_date, end_date, description, language)
Create a public progress page for an event (needs an API key whose contact e-mail is confirmed; max 10 per day). The event is unlisted: it is reachable by its URL but not featured in the catalogue or sitemap. Dates are inclusive calendar days.
Input Schema
{
"type": "object",
"properties": {
"name": {
"type": "string",
"minLength": 3,
"maxLength": 120
},
"start_date": {
"type": "string",
"description": "First day, YYYY-MM-DD."
},
"end_date": {
"type": "string",
"description": "Last day (inclusive), YYYY-MM-DD, not before start_date."
},
"description": {
"type": "string",
"maxLength": 500
},
"language": {
"type": "string",
"enum": [
"fr",
"en"
],
"description": "Language of the page. Default en."
}
},
"required": [
"name",
"start_date",
"end_date"
]
}Community
Evidence