Metadata-Version: 2.4
Name: bonddekho-mcp
Version: 0.3.0
Summary: MCP server for querying Indian corporate bond data from BondDekho
Project-URL: Homepage, https://www.bonddekho.com
Project-URL: Package, https://pypi.org/project/bonddekho-mcp/
Project-URL: Documentation, https://www.bonddekho.com/about
License-Expression: MIT
Keywords: bonds,finance,india,mcp,model-context-protocol,ncd
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Requires-Python: >=3.10
Requires-Dist: fastmcp>=2.0.0
Description-Content-Type: text/markdown

# BondDekho MCP Server

Query Indian corporate bond data from [BondDekho](https://www.bonddekho.com) via the Model Context Protocol. Compare yields, ratings, and prices across 9+ platforms (GoldenPi, WintWealth, IndiaBonds, Jiraaf, and more).

## Quick Start

### Option 1: Remote (no install needed)

Point your MCP client at the hosted endpoint:

```json
{
  "mcpServers": {
    "bonddekho": {
      "url": "https://www.bonddekho.com/mcp/sse"
    }
  }
}
```

### Option 2: Install via pip

```bash
pip install bonddekho-mcp
```

Then add to your MCP client config:

```json
{
  "mcpServers": {
    "bonddekho": {
      "command": "bonddekho-mcp"
    }
  }
}
```

### Option 3: Run from source

```bash
pip install -r requirements.txt
python server.py
```

## Where to add the config

| Client | Config location |
|--------|----------------|
| Claude Desktop | `~/Library/Application Support/Claude/claude_desktop_config.json` |
| Claude Code | `.mcp.json` in project root or `~/.claude/settings.json` |
| Cursor | Settings > MCP Servers |
| Windsurf | Settings > MCP |

## Available Tools

| Tool | Description |
|------|-------------|
| `search_bonds` | Search bonds by issuer, ISIN, or sector with optional filters (rating, YTM range, platform) |
| `get_bond` | Get full details for a specific bond by ISIN including platform pricing |
| `compare_bonds` | Side-by-side comparison of 2-5 bonds in a table |
| `get_market_stats` | Overall market statistics: total bonds, avg YTM, rating distribution, platform overview |
| `get_issuer_bonds` | All bonds from a specific issuer with YTM and platform data |

## Example Prompts

Once configured, you can ask your AI assistant:

- "What bonds does Muthoot Finance offer?"
- "Show me AAA rated bonds with YTM above 8%"
- "Compare bonds INE101Q07AS3 and INE296G07218"
- "What's the average bond YTM across Indian platforms?"
- "Find NBFC bonds available on GoldenPi"

## Data Source

All data is sourced from [BondDekho](https://www.bonddekho.com), which aggregates bond listings from 9+ SEBI-registered Online Bond Platform Providers. Data is refreshed 4x daily.

BondDekho is a data aggregation platform, not a SEBI-registered investment adviser. All information is for educational purposes only.

## License

MIT
