# MarketMind MCP

Indian market intelligence tools for Claude, Cursor, and any MCP-compatible AI assistant.

[![PyPI version](https://img.shields.io/pypi/v/marketmind-mcp)](https://pypi.org/project/marketmind-mcp/)
[![Python](https://img.shields.io/pypi/pyversions/marketmind-mcp)](https://pypi.org/project/marketmind-mcp/)

## What it does

Gives your AI assistant real-time access to:
- NSE market status & hours
- Company info and ticker lookups (5000+ NSE listed companies)
- Next market open time
- IST-aware date/time tools

## Requirements

- Python 3.10+
- Redis running locally (`redis-server`)

## Installation

```bash
pip install marketmind-mcp
```

Or with `uvx` (no install needed):

```bash
uvx marketmind-mcp
```

## Setup for Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "marketmind": {
      "command": "uvx",
      "args": ["marketmind-mcp"]
    }
  }
}
```

**Config file location:**
- macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`
- Windows: `%APPDATA%\Claude\claude_desktop_config.json`

## Setup for Cursor

Add to your Cursor MCP settings:

```json
{
  "marketmind": {
    "command": "uvx",
    "args": ["marketmind-mcp"]
  }
}
```

## Available Tools

| Tool | Description |
|------|-------------|
| `get_current_time` | Current IST date, time, day |
| `get_current_date` | Current IST date |
| `market_status` | Is NSE open right now? |
| `next_market_open` | Next NSE opening date & time |
| `get_company_info` | Company name from ticker symbol |
| `find_symbol_by_name` | Ticker symbol from company name |
| `ping` | Health check |
| `get_supported_exchanges` | Supported exchanges list |

## Example prompts (in Claude)

> "Is NSE open right now?"

> "What's the ticker symbol for Infosys?"

> "When does the market open next?"

> "Get company info for RELIANCE"

## Links

- Developer Portal: [developers.marketmind-hub.in](https://developers.marketmind-hub.in)
- Support: support@marketmind-hub.in

## License

MIT