NepseAPI Unofficial

finance MCP Server

Unlock Nepal Stock Exchange (NEPSE) data with this powerful unofficial API. Features REST, WebSocket, and a first-of-its-kind Model Context Protocol (MCP) server, enabling AI models like Claude to perform live market analysis with over 20 specialized tools. Strictly for educational and non-commercial use.

Verified
financefinance
4 views48 stars21 forksMIT

Why This Matters

Discovered via github-topic:mcp and last synced 4mo ago.

Verified
Source
github-topic:mcp
Stars
48
Last synced
4mo ago
Install
Check source

Install

Install instructions not detected yet

Check the source repository for the latest setup steps.

View source instructions
29
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (29)

60

All other endpoints

get_live_market_data

Get live market data

get_stock_suggestions

Get suggestions for a stock symbol

120

`/validate/*` endpoints

get_price_volume

Get price and volume data

validate_index_name

Validate an index name

get_top_stocks_by_transactions

Get top stocks by transactions

6

MCP tool queries

get_top_losers

Get top losing stocks

get_validation_stats

Get validation statistics

Service

URL

get_company_list

Get a list of all companies

get_company_details

Get details for a specific company

Endpoint

Description

get_nepse_index

Get NEPSE index data

get_sector_data

Get data for a specific sector

Description

Parameters

get_supply_demand

Get market supply/demand data

get_top_stocks_by_turnover

Get top stocks by turnover

200

`/health` endpoint

get_market_summary

Get current market summary

validate_stock_symbol

Validate a stock symbol

get_top_stocks_by_volume

Get top stocks by volume

100

WebSocket connections & messages

get_top_gainers

Get top gaining stocks

get_index_suggestions

Get suggestions for an index name

None

### Example Usage ```bash # Validate a stock symbol curl "http://localhost:8000/validate/stock/NABIL" # Get suggestions for invalid symbol curl "http://localhost:8000/validate/suggestions/stock/NABIL123" # Validate an index name curl "http://localhost:8000/validate/index/Banking" ``` ### Response Format **Valid Symbol:** ```json { "symbol": "NABIL", "is_valid": true, "suggestions": [] } ``` **Invalid Symbol with Suggestions:** ```json { "symbol": "NABIL123", "is_valid": false, "suggestions": ["NABIL", "NABBC", "NICA"] } ``` For detailed information about the validation system, see [VALIDATION_SUMMARY.md](VALIDATION_SUMMARY.md). ## MCP Tools Available The MCP server provides the following tools for AI integration, with endpoint-level caching (10-minute TTL) for faster repeat queries:

get_floorsheet

Get floorsheet data

get_sub_indices

Get data for all sub-indices