Skip to main content

Randonneuring Intelligence MCP Server

PyPI version Python 3.10+ License: MIT

AI-powered analysis of randonneuring cycling event data through Model Context Protocol (MCP)

An MCP server that exposes 53 specialized tools for analyzing randonneuring cycling events. Works with Kiro, Claude Desktop, and any MCP-compatible AI client.

What is This?

This MCP server lets AI agents analyze randonneuring (long-distance cycling) event data through natural language. It provides:

  • 21 LRM tools - Worldwide Long Randonnée Medal results
  • 32 Audax India tools - Indian randonneuring event data

Ask questions like:

  • "Show me all 1200km events in Maharashtra last year"
  • "What's the completion rate for Paris-Brest-Paris?"
  • "Which clubs organized the most events in 2023?"

The AI uses the appropriate tools to answer your questions.

Quick Start

Installation

pip install randonneuring-intelligence-mcp

Configure in Kiro

Add to your Kiro MCP config (C:\Users\<username>\.kiro\settings\mcp.json on Windows):

{
  "mcpServers": {
    "randonneuring-intelligence": {
      "command": "randonneuring-mcp"
    }
  }
}

Configure in Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (Mac) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "randonneuring-intelligence": {
      "command": "randonneuring-mcp"
    }
  }
}

Restart Your AI Client

Restart Kiro or Claude Desktop to load the server.

Features

LRM (Long Randonnée Medal) - 21 Tools

Filters (8 tools)

  • Filter by year, rider name, country, event, club, distance, gender, time

Analysis (5 tools)

  • Rider statistics, club statistics, event statistics
  • Time analysis, gender distribution

Queries (6 tools)

  • List riders, clubs, events, countries, distances, years

Audax India - 32 Tools

Event Filters (7 tools)

  • Filter by year, club, location, state, distance, status, type

Participant Filters (5 tools)

  • Filter by name, club, result status, medal, fee payment

Analysis (6 tools)

  • Event statistics, club statistics, participant statistics
  • Completion rates, state statistics, yearly trends

Queries (8 tools)

  • List clubs, locations, states, distances, years
  • List participants, participant clubs, rider numbers

Example Queries

"Show me all 600km BRM events in Karnataka in 2023"
→ AI chains: audax_filter_by_year + audax_filter_by_distance + audax_filter_by_state

"What are the completion rates for different distances?"
→ AI calls: audax_get_completion_rates

"Show me John Smith's LRM statistics"
→ AI calls: lrm_get_rider_stats

"Which clubs have organized the most events?"
→ AI calls: audax_get_club_statistics

Data

The package includes bundled data files (~23 MB):

  • LRM worldwide results
  • Audax India event catalog with participant details

Data is loaded once at startup for fast query performance.

Requirements

  • Python 3.10 or higher
  • Works with any MCP-compatible AI client:

Architecture

AI Agent (Kiro/Claude)
       ↓
MCP Protocol (STDIO)
       ↓
This MCP Server
       ↓
randonneuring-intelligence (business logic)
       ↓
Bundled JSON Data Files

Development

Install from Source

git clone https://github.com/mprathappandian/randonneuring-intelligence-mcp.git
cd randonneuring-intelligence-mcp
pip install -e .

Run Tests

pip install -e ".[dev]"
pytest

Advanced Configuration

Custom Data Directory

Set environment variable to use your own data files:

{
  "mcpServers": {
    "randonneuring-intelligence": {
      "command": "randonneuring-mcp",
      "env": {
        "RANDONNEURING_DATA_DIR": "/path/to/your/data"
      }
    }
  }
}

Debug Logging

{
  "mcpServers": {
    "randonneuring-intelligence": {
      "command": "randonneuring-mcp",
      "env": {
        "LOG_LEVEL": "DEBUG"
      }
    }
  }
}

Troubleshooting

Server Won't Start

  1. Check Python version: python --version (must be 3.10+)
  2. Verify installation: pip show randonneuring-intelligence-mcp
  3. Test manually: randonneuring-mcp (should show startup logs)

Tools Not Working

  1. Check logs in your AI client's console
  2. Enable debug logging (see Advanced Configuration)
  3. Verify data files loaded (check startup logs)

Import Errors

Ensure randonneuring-intelligence is installed:

pip install randonneuring-intelligence

License

MIT License - see LICENSE file for details.

Author

Prathap Pandian

Acknowledgments

Built with:

Version History

0.1.0 (2024-11-18)

  • Initial release
  • 53 tools (21 LRM + 32 Audax India)
  • Bundled data files
  • Support for Kiro and Claude Desktop

Metadata

Release files for randonneuring-intelligence-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for randonneuring-intelligence-mcp 0.1.0
File Size Uploaded Provenance Actions
randonneuring_intelligence_mcp-0.1.0.tar.gz 1.6 MB Without provenance Details for randonneuring_intelligence_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for randonneuring-intelligence-mcp 0.1.0
File Interpreter ABI Platform Actions
randonneuring_intelligence_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for randonneuring_intelligence_mcp-0.1.0-py3-none-any.whl

Total release size: 3.4 MB

Release files / randonneuring_intelligence_mcp-0.1.0.tar.gz

Download URL randonneuring_intelligence_mcp-0.1.0.tar.gz
Size 1.6 MB
Tags Source
SHA-256 checksum
How to use checksums
a352e781984ca4634875c66e497bcd26ec961bd0bfd04b8c7f80ea34b5c04cf0
BLAKE2b-256 checksum
How to use checksums
54a619127058dd0a47bd22f79a43dbe303dcb936c5b7128ea605d7f5ba5ce794
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.3

Release files / randonneuring_intelligence_mcp-0.1.0-py3-none-any.whl

Download URL randonneuring_intelligence_mcp-0.1.0-py3-none-any.whl
Size 1.7 MB
Tags Python 3
SHA-256 checksum
How to use checksums
b4ea857bcd1d253610d76343dea01d506cb73da4a8ed4935ff7450d60bd3d6f8
BLAKE2b-256 checksum
How to use checksums
e7bd92cfef617d591557afffc8f320c7bddb58dbec21bf0888ecd32c47e618a3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.3

Security for randonneuring-intelligence-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page