Cricket Analytics MCP
This server does not currently have a deployable release on Glama. Follow the repository's setup instructions to install and configure it for your MCP client, including any required credentials and local dependencies.
๐ Cricket Analytics MCP
An AI-powered Cricket Analytics Agent built with Model Context Protocol (MCP), OpenAI, Python, and Streamlit.
The project allows users to explore cricket statistics and ask natural-language questions about players, teams, matches, and player comparisons through an AI-powered interface.
โจ Features
๐ Cricket player statistics
๐ Player performance analysis
โ๏ธ Compare two cricket players
๐ Team statistics and analysis
๐ Match results and recent matches
๐ฐ Cricket news search
๐ค OpenAI-powered cricket analyst
๐ MCP server for exposing cricket tools
๐จ Interactive Streamlit web interface
๐ Environment-based API key configuration
Related MCP server: cricket-mcp
๐๏ธ Architecture
โโโโโโโโโโโโโโโโโโโโโโโ
โ Streamlit UI โ
โ streamlit_app.py โ
โโโโโโโโโโโโฌโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโ
โ OpenAI Agent โ
โ agent_openai.py โ
โโโโโโโโโโโโฌโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโ
โ MCP Server โ
โ server.py โ
โโโโโโโโโโโโฌโโโโโโโโโโโ
โ
โผ
โโโโโโโโโโโโโโโโโโโโโโโ
โ Data Provider โ
โ data_provider.py โ
โโโโโโโโโโโโโโโโโโโโโโโ๐ Project Structure
cricket-analytics-mcp/
โ
โโโ agent_openai.py # OpenAI-powered cricket agent
โโโ data_provider.py # Cricket data and statistics provider
โโโ server.py # MCP server and cricket tools
โโโ streamlit_app.py # Streamlit frontend
โ
โโโ screenshots/ # Application screenshots
โ โโโ player-stats.png
โ โโโ player-comparison.png
โ โโโ dashboard.png
โ
โโโ .env # API keys and configuration (not committed)
โโโ .gitignore # Git ignored files
โโโ requirements.txt # Python dependencies
โโโ README.md # Project documentation๐ ๏ธ Tech Stack
Python
OpenAI API
Model Context Protocol (MCP)
Streamlit
python-dotenv
Cricket statistics/data sources
๐ง MCP Tools
The MCP server can expose cricket-focused tools such as:
get_player_stats()
get_team_stats()
get_match_results()
get_player_comparison()
get_recent_matches()
search_cricket_news()These tools allow the AI agent to retrieve structured cricket information and use it to answer user questions.
๐ฌ Example Queries
Show me Virat Kohli's ODI statistics.
Compare Virat Kohli and Rohit Sharma in ODI cricket.
Show me the recent matches of India.
Give me the Test statistics of Virat Kohli.
Compare the performance of two cricket players.
Show recent cricket news.โ๏ธ Installation
1. Clone the repository
git clone https://github.com/manasranjanmeher99/Cricket-Analytics-MCP.git
cd Cricket-Analytics-MCP2. Create a virtual environment
Windows:
python -m venv .venv
.venv\Scripts\activate3. Install dependencies
pip install -r requirements.txt4. Configure environment variables
Create a .env file in the project root:
OPENAI_API_KEY=your_openai_api_key
OPENAI_MODEL=gpt-5.6
CRICAPI_KEY= xxxxxxxNever commit your .env file to GitHub.
โถ๏ธ Running the Application
Start the Streamlit application
streamlit run streamlit_app.pyThen open the local Streamlit URL shown in your terminal.
Start the MCP server
If your project is configured to run the MCP server separately:
python server.pyFollow the MCP configuration used by your client/agent setup.
๐งช Project Workflow
User Question
โ
Streamlit Interface
โ
OpenAI Agent
โ
MCP Tool Selection
โ
MCP Server
โ
Cricket Data Provider
โ
Structured Cricket Data
โ
OpenAI Analysis
โ
Streamlit Response๐ Environment Variables
Variable Description
OPENAI_API_KEY OpenAI API key
OPENAI_MODEL OpenAI model used by the agent
CRICAPI_KEY Cric API key
Example:
OPENAI_API_KEY=sk-xxxxxxxx
OPENAI_MODEL=gpt-5.6
CRICAPI_KEY= xxxxxxx๐ธ Screenshots
Recommended screenshots:
Player statistics
Player comparison
Cricket analytics dashboard
Then reference them in this README:


๐ Future Improvements
Live cricket scores
Live match commentary
Player rankings
Advanced player comparison charts
Team performance analytics
Historical match analysis
Cricket news aggregation
More MCP tools
Improved dashboard visualizations
Deployment to Streamlit Community Cloud
๐ฏ Use Cases
This project can be used for:
Cricket statistics exploration
Player performance analysis
AI-powered cricket research
Cricket data visualization
MCP learning and experimentation
Agentic AI portfolio development
๐จโ๐ป Author
Manas Ranjan Meher
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogโฆ
This server cannot be deployed
Maintenance
Related MCP Connectors
Cricket MCP โ wraps CricAPI (api.cricapi.com) for live cricket data.
Ask Claude, ChatGPT, or any MCP client about your game's players, retention, revenue, and win rates.
Query your warehouse or a CSV with Claude/ChatGPT over MCP, governed by table-level ACL + audit.
Connect your ads, shop, analytics, social, CRM and finance platforms once, then let Claude, ChatGPT, Cursor or any MCP client read, join and explain your numbers. Public statistics from the World Bank, IMF, Eurostat, OECD, WHO and SEC filings come as context, searchable and chartable from the same tools. Read-only by design, every number carries its source.
Related MCP Servers
- FlicenseBqualityDmaintenanceProvides natural language access to IPL cricket match data, allowing users to query player statistics, team performances, and match results. It utilizes a SQLite backend and Cricsheet data to deliver detailed cricket analytics through the Model Context Protocol.1-
- FlicenseNot gradedqualityBmaintenanceAn MCP server that enables natural language querying of over 10 million ball-by-ball cricket deliveries stored in a local DuckDB database. It provides 26 tools for analyzing player matchups, situational stats, and historical records across all major cricket formats and tournaments.3-
- AlicenseNot gradedqualityBmaintenanceWraps CricAPI to provide live cricket data, enabling AI agents to query cricket information through natural language or direct tool calls.92 npm1MIT
- AlicenseNot gradedqualityBmaintenanceEnables plain-language cricket analytics for MCP clients, including calibrated win probability, ball-by-ball match archives, career and matchup records, venue and phase stats, and live scores, all without an API key.BSD 3-Clause