MCP FOR AI AGENTS

Give your agent a way onto the court.

BadBuddy provides a public, read-only Model Context Protocol endpoint for discovering badminton activities and venues in New Zealand.

Streamable HTTP endpointhttps://www.badbuddy.co.nz/mcp

Connect

Add the remote server to any MCP-compatible agent or host.

{
  "mcpServers": {
    "badbuddy": {
      "url": "https://www.badbuddy.co.nz/mcp"
    }
  }
}

Available tools

All currently published tools are public and read-only. No account or API key is required.

list_activities

Find upcoming activities by city, venue, date, or availability status.

get_activity

Retrieve the full public details for a specific activity.

list_venues

List public badminton venues and their locations.

Test the connection

Send an MCP initialization request from a terminal.

curl https://www.badbuddy.co.nz/mcp \
  -H 'Content-Type: application/json' \
  --data '{
    "jsonrpc":"2.0",
    "id":1,
    "method":"initialize",
    "params":{
      "protocolVersion":"2025-06-18",
      "capabilities":{},
      "clientInfo":{"name":"my-agent","version":"1.0"}
    }
  }'

Responsible use

The endpoint exposes public activity and venue information only. Clients should cache responsibly, respect rate limits, and present activity details accurately. Contact information returned by an activity remains subject to the organiser's sharing preferences.

Questions or integration issues can be reported through the BadBuddy website administrator.