azkena

Azkena is the Model Context Protocol (MCP) server for the Pilotariak platform. It exposes Basque pelota competition data as MCP tools so AI assistants (Claude Desktop, Cursor, Copilot Workspace, etc.) can query competitions, clubs, results, and more through natural language.

Built as a Cloudflare Worker using @modelcontextprotocol/sdk.

MCP Tools

All tools accept a league parameter: lcapb · lidfpb · ccapb · ctpb

Protocol

Azkena speaks the MCP 2026-07-28 stateless core:

• No initialize/initialized handshake — every request is self-describing

• server/discover for capability pre-fetching

• MCP-Protocol-Version: 2026-07-28 response header

• Mcp-Method / Mcp-Name header-based routing (SEP-2243)

• ttlMs / cacheScope cache hints on list-type tool responses (SEP-2549)

Quick Start

npm install
make dev       # → http://localhost:8787

See AGENTS.md for full developer documentation, Claude Desktop integration, and deployment.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request. See CONTRIBUTING

License

See LICENSE