Skip to main content
Glama
mcp-meroshare

mcp-meroshare

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: groww-mcp

Tools

Tool

Description

meroshare_get_dp_list

List all DPs with their numeric client IDs

meroshare_login

Log in (password read from .env)

meroshare_logout

Clear session

meroshare_get_current_issues

Open IPO/FPO/Rights issues

meroshare_apply_ipo

Apply for an issue (with dry-run)

meroshare_get_bank_details

Linked bank account info

meroshare_get_own_detail

Your profile (BOID, demat, email)

meroshare_get_transactions

Share transaction history

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.

  1. Lock the file: chmod 600 .env

  2. Add to your opencode.json:

{
  "mcp": {
    "meroshare": {
      "type": "local",
      "command": ["python3", "-m", "mcp_meroshare"],
      "enabled": true
    }
  }
}
  1. 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

Available Tools

10 tools
meroshare_apply_ipoB

Apply for an IPO/FPO/Rights issue. Use dry_run=true to preview without submitting.

Inputs: company_share_id (required), applied_kitta (required), demat (required), boid (required), +6 more.

meroshare_check_ipo_resultB

Check IPO/FPO allotment result for a specific issue

Inputs: company_share_id (required), boid (required).

meroshare_get_application_reportsA

Get all submitted IPO/FPO/Rights application reports

Inputs: include_old.

meroshare_get_bank_detailsB

Get linked bank account details using your demat number (16-digit)

Inputs: demat (required).

meroshare_get_current_issuesA

List all currently open IPO, FPO, and Rights share issues available for application

Inputs: no named parameters.

meroshare_get_dp_listA

List all Depository Participants with their numeric client IDs (call this first to find your client_id)

Inputs: no named parameters.

meroshare_get_own_detailA

Get your own account/profile details (name, BOID, demat, email)

Inputs: no named parameters.

meroshare_get_transactionsC

Get share transaction history

Inputs: boid (required), from_date, to_date.

meroshare_loginA

Log in to MeroShare. Password is read from MERO_SHARE_PASSWORD in .env

Inputs: client_id (required), username (required).

meroshare_logoutA

Log out of MeroShare and clear the session

Inputs: no named parameters.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.7/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose, from login/logout to applying for IPOs and checking results, with no overlapping functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun snake_case pattern prefixed with 'meroshare', making them predictable and easy to distinguish.

    Tool Count5/5

    With 10 tools, the server covers authentication, account details, IPO lifecycle, transactions, and bank info—well-scoped for a stock market application.

    Completeness4/5

    Covers core IPO operations and account management well, but lacks a direct tool for viewing current portfolio holdings, though transaction history partially covers it.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Model Context Protocol (MCP) to enable AI LLMs to trade using MetaTrader platform
      558 PyPI
      852
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables users to manage equity holdings, execute trades, and track market data on Groww using natural language. It supports mutual fund investments and SIP management, including a mock mode for risk-free testing.
      23
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server for the Groww trading platform. This enables LLM applications to interact with your Groww trading account.
      5
      -