# Kicksmash

> Kicksmash is an open-source MCP server for sports data. Open API and MCP server for organising padel matches with one shareable link. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** Web, API, CLI, Telegram, Discord, Self-hosted
- **Website:** https://kicksma.sh/developers
- **Repository:** https://github.com/evhg/padel-matchup
- **MCP Registry name:** sh.kicksma/kicksmash
- **Categories:** [sports data](https://ai-powered.com/categories/sports-data)
- **Listing updated:** 2026-11-20

## About

The README says Kicksmash runs padel matches from a single link, with no app install and no account; a player enters a first name and joins. The site's own description adds that assistants and developers can drive the same flow through an MCP server, a REST API and signed webhooks.

Matches can be created, read, joined and scheduled by people or by AI assistants. Americano, mexicano and King of the Court schedules are available through the API and through npm packages released under the same open licence. Groups, calendar feeds for groups and venues, and a Telegram bot that keeps a live match card in a group chat are also part of the product.

It suits padel organisers, players who coordinate in group chats, clubs that want a public venue board, and developers building padel tools or assistant integrations.

## Features

- **Single-link match sharing:** Matches are shared through one link, and joining requires only a first name.
- **MCP server endpoint:** An MCP endpoint at kicksma.sh/mcp lets assistants read, create and join matches.
- **REST API with OpenAPI:** Public read endpoints need no key, and writes accept an optional key for higher limits.
- **Signed webhooks:** Webhooks fire on match events and are signed with HMAC-SHA256 for verification.
- **Americano schedule generation:** Schedules for americano, mexicano and King of the Court formats are available through the API and npm packages.
- **Calendar feeds:** Group and venue .ics feeds let members subscribe once and see every match.

## Good for

- Organising a weekly padel game and sharing one link with the group
- Letting an AI assistant create a match and invite players
- Generating a round-robin schedule for a tournament day
- Building a padel tool that reads public match and venue data
- Showing upcoming open matches on a club's public venue board

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http kicksmash https://kicksma.sh/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://kicksma.sh/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "kicksmash": {
      "url": "https://kicksma.sh/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "kicksmash": {
      "type": "http",
      "url": "https://kicksma.sh/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "kicksmash": {
      "serverUrl": "https://kicksma.sh/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://kicksma.sh/mcp
```

Enter a Name (for example "Kicksmash"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "kicksmash": {
      "type": "http",
      "url": "https://kicksma.sh/mcp"
    }
  }
}
```

## Tools

- `about_kicksmash`: Describes the Kicksmash service.
- `get_match`: Reads a match.
- `find_matches`: Finds matches.
- `get_group`: Reads a group.
- `generate_schedule`: Generates a match schedule.
- `create_match`: Creates a match.
- `join_match`: Joins a match.
- `create_api_key`: Creates an API key.
- `find_clubs`: Finds clubs.
- `find_series`: Finds recurring Opens.
- `find_coaches`: Finds padel coaches.
- `coach_slots`: Lists coach availability.
- `request_coach`: Requests a coach.
- `book_lesson`: Books a lesson.
- `cancel_lesson`: Cancels a lesson.

## FAQ

### Do I need an account to join a match?

No. The site says joining needs only a first name and a link, with no accounts or app.

### Is the API free to use?

The site lists free limits without a key: 600 reads an hour and 12 writes a day per address. A free key raises writes to 300 a day and unlocks webhooks.

### Which licences apply?

The code is Apache-2.0 and public match and schedule data is CC BY 4.0, with attribution to Kicksmash, kicksma.sh.

### How do I connect the MCP server?

The site gives the URL https://kicksma.sh/mcp and setup steps for Claude connectors and the Claude CLI, with no authentication needed for the connector.

### How do I add Kicksmash to Claude Code?

Run this command in your terminal: claude mcp add --transport http kicksmash https://kicksma.sh/mcp

### What are the best alternatives to Kicksmash?

The closest alternatives to Kicksmash are CourtsApp, Padel Analyst, La Porra, The Pitch Network and Kickjolly Football.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [CourtsApp](https://ai-powered.com/mcp/courtsapp): CourtsApp is an MCP server for sports data.
- [Padel Analyst](https://ai-powered.com/mcp/padel-analyst): Padel Analyst is a paid MCP server for sports data.
- [La Porra](https://ai-powered.com/mcp/la-porra): La Porra is a freemium MCP server for sports data.
- [The Pitch Network](https://ai-powered.com/mcp/the-pitch-network): The Pitch Network is a free MCP server for sports data.
- [Kickjolly Football](https://ai-powered.com/mcp/kickjolly-football): Kickjolly Football is an MCP server for sports data.
- [CourtWatch Agent API](https://ai-powered.com/mcp/courtwatch-agent-api): CourtWatch Agent API is an MCP server for sports data.
- [JoGo](https://ai-powered.com/mcp/jogo): JoGo is a free MCP server for sports data.
- [Sports](https://ai-powered.com/mcp/sports-2): Sports is an open-source MCP server for sports data.

---
Source: https://ai-powered.com/mcp/kicksmash
