mcp-meroshare

MCP (Model Context Protocol) server for MeroShare — Nepal's online share application system by CDSC Nepal.

Use it through opencode or any MCP-compatible client to manage IPO/FPO applications, portfolio, and share transactions directly from your AI tools.

Features

• IPO/FPO Application — view open issues, apply with dry-run support

• Portfolio — check your holdings and transaction history

• Account — view DP list, own details, linked bank accounts

Related MCP server: kubera-mcp

Tools

Installation

pip install mcp-meroshare

Setup

1. Create a .env file in the directory where you'll run opencode:

MERO_SHARE_CLIENT_ID=162
MERO_SHARE_USERNAME="your_boid"
MERO_SHARE_PASSWORD="your_password"
MERO_SHARE_CRN_NUMBER="your_casba_crn"
MERO_SHARE_TRANSACTION_PIN="your_tpin"

Find your client_id by calling meroshare_get_dp_list.

2. Lock the file: chmod 600 .env

3. Add to your opencode.json:

{
  "mcp": {
    "meroshare": {
      "type": "local",
      "command": ["python3", "-m", "mcp_meroshare"],
      "enabled": true
    }
  }
}

4. Run opencode in that directory and call meroshare_login with your client_id and username.

Security

• Credentials are read only from .env — never passed as tool arguments

• Session auto-expires after 15 minutes of inactivity

• .env file permission warning if world-readable

License

MIT