How do I use GoldenPi Bonds MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@GoldenPi Bonds MCP Server show AAA rated bonds with yield above 9%" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

GoldenPi Bonds MCP Server

by hackbansu

Overview Schema Related Servers Score Discussions

Python

Remote

GoldenPi Bonds MCP Server

A Model Context Protocol server that exposes GoldenPi's reverse-engineered bond discovery APIs.

Tools:

goldenpi_list_bonds — filtered, paginated bond listing via POST /v0/bonds/list
goldenpi_search_bonds — free-text bond search via POST /v0/bonds/search

Installation

cd goldenpi-mcp
python -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
cp .env.example .env

Related MCP server: Tesouro Direto MCP Server

Configuration

Copy .env.example to .env and edit as needed:

cp .env.example .env

Key variables:

Variable	Default	Purpose
`GOLDENPI_BASE_URL`	`https://api.goldenpi.com`	GoldenPi API base URL
`GOLDENPI_CLIENT_TOKEN`	(none)	Optional static token. If unset or rejected, the server falls back to `/v0/auth/handshake`.
`GOLDENPI_PARTNER_ID`	`GoldenPi-Securities`	Partner ID sent during handshake
`GOLDENPI_SEND_DEPOSITORY_HEADER`	`0`	Set to `1` to send `x-gpi-client-depositoryid` on POSTs. Off by default because the live API rejects it on bond endpoints.
`GOLDENPI_MCP_TRANSPORT`	`stdio`	`stdio` for OpenCode/Claude Desktop, `sse` for ChatGPT apps
`GOLDENPI_MCP_HOST` / `GOLDENPI_MCP_PORT`	`0.0.0.0` / `8080`	SSE server bind address

Auth behavior:

Uses GOLDENPI_CLIENT_TOKEN if set.
If the static token fails with an auth/header error, automatically calls POST /v0/auth/handshake to obtain a guest token and retries.
If handshake also fails, the server exits immediately with a clear error.

Note: As of the latest test, the embedded static token from the frontend bundle is rejected by the live API. The handshake guest token works, so leaving GOLDENPI_CLIENT_TOKEN unset (or commented out) is the most reliable default.

Header note: The frontend only sends x-gpi-client-token on POST requests. Sending x-gpi-client-depositoryid on POST /v0/bonds/list causes an "invalid header" error, so this server does not send it by default. Set GOLDENPI_SEND_DEPOSITORY_HEADER=1 only if you specifically need it.

Running locally (stdio / OpenCode / Claude Desktop)

python -m goldenpi_mcp.server

OpenCode / Claude Desktop config:

{
  "mcpServers": {
    "goldenpi-bonds": {
      "command": "python",
      "args": ["-m", "goldenpi_mcp.server"],
      "env": {
        "GOLDENPI_DEPOSITORY_ID": "GoldenPi"
      }
    }
  }
}

Running for ChatGPT / SSE clients

python -m goldenpi_mcp.server --transport sse --host 0.0.0.0 --port 8080

Your ChatGPT app should connect to:

http://localhost:8080/sse

Tool reference

`goldenpi_list_bonds`

Filtered, paginated bond discovery via POST /v0/bonds/list. Does not support free-text search — use goldenpi_search_bonds for name/ISIN/issuer queries.

Pagination & sorting

Parameter	Type	Description
`sort_by`	enum	How to sort. Default: `yield-high-to-low`.
`limit`	int	Results per page. Range: 1–50. Default: 10.
`offset`	int	1-based page number. Default: 1.

Core filters

Parameter	Type	Description
`asset_classes`	list	Instrument types: `NCD`, `NCD-IPO`, `GSEC`, `SDL`, `CGTB`, `SGB-IPO`. Defaults to `NCD`, `NCD-IPO`.
`credit_ratings`	list	`aaa`, `aa`, `a`, `sovereign`. `sovereign` matches government securities.
`min_yield` / `max_yield`	number	YTMC % range. Omit either side for open-ended.
`min_investment_inr` / `max_investment_inr`	number	Settlement amount per lot in INR.
`payment_frequencies`	list	`annual`, `half-yearly`, `quarterly`, `monthly`, `thrice-yearly`, `on-maturity`.
`issuer_types`	list	`nbfc`, `corporate`, `psu`, `psb`, `bank`, `government`, `gsec`, `sdl`, `rbi`. `gsec`/`sdl` also enable government asset classes.
`min_tenure_months` / `max_tenure_months`	int	Remaining tenure in whole months. Ignored if `tenure_preset` is set.
`tenure_preset`	enum	Shortcut: `less-than-1y`, `1-5y`, `5-10y`, `more-than-10y`, `short-term-3y`.
`investment_purpose`	enum	Strategy preset applying multiple filters at once, e.g. `highest-safety`, `tax-free-investment`, `invest-short-time`.

Boolean flags

Parameter	Description
`tax_free_only`	Tax-free bonds only. Mutually exclusive with `taxable_only`.
`taxable_only`	Taxable bonds only.
`nri_eligible_only`	NRI-eligible bonds only.
`secured_only` / `unsecured_only`	Secured or unsecured only. Mutually exclusive.
`perpetual_only` / `non_perpetual_only`	Perpetual or non-perpetual only. Mutually exclusive.
`call_option_only` / `no_call_option_only`	With or without call option. Mutually exclusive.
`pledge_for_fno_only`	Accepted as pledge for F&O margin.
`huf_tax_exemption_only`	HUF tax exemption available.
`spotlight_only`	Featured/spotlight bonds only.

Advanced filters

Parameter	Type	Description
`issuer_mode`	enum	`public` (Public Placement) or `private` (Private Placement).
`face_values`	list	`1000`, `10000`, `100000`, `200000`, `1000000`, `above-10-lacs`. Combined into a range.
`bond_price_level`	enum	`discount`, `par`, `premium`.
`bank_bond_tier`	enum	`tier_i`, `tier_ii`, `tier_iii`.
`seniority`	enum	`senior` or `subordinate`.
`depository_listing`	enum	`nsdl`, `cdsl`, `both`.
`listed`	list	Override listing filter. `[1]` = active deals, `[0]` = primary/IPO, `[0,1]` = both.
`include_marketing_details`	bool	Include featured/UTSAV campaign metadata.

Output:

{
  "totalCount": 123,
  "filteredCount": 45,
  "hasMore": true,
  "bonds": [ /* full instList rows */ ]
}

`goldenpi_search_bonds`

Free-text search across bonds/FDs/IPOs via POST /v0/bonds/search.

Parameter	Required	Description
`search_filter`	yes	Name, ISIN, or issuer text. Minimum 2 characters.
`sort_by`	no	`yield-high-to-low` (default) or `yield-low-to-high`.
`limit`	no	Results per page. Range: 1–50. Default: 10.
`offset`	no	1-based page number. Default: 1.

Testing

pytest

Legal / risks

This is an unofficial reverse-engineered integration. GoldenPi may change their API without notice. Use at your own risk and respect their terms of service.

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

Israeli Land Authority MCP
Government Data Open Data Real Estate
barvhaim
A
license
A
quality
D
maintenance
Provides programmatic access to Israeli Land Authority (רמ״י) public tender data, allowing comprehensive search and filtering of land tenders by type, location, status, and dates.
Updated a year ago (2025-09-17 06:49 UTC)
7
15
MIT
Tesouro Direto MCP Server
Finance Government Data Search
AtilioA
A
license
-
quality
D
maintenance
Enables natural language access to Brazilian treasury bond data through the Tesouro Direto API. Query market data, bond details, and search bonds by type, maturity, and other criteria.
Updated 6 months ago (2026-02-14 10:51 UTC)
29
5
AGPL 3.0
kite-mcp-server
Finance Autonomous Agents
Sundeepg98
A
license
-
quality
B
maintenance
Indian stock market trading via Zerodha Kite Connect. 78 tools for order execution, portfolio analytics, options Greeks, paper trading, backtesting, technical indicators, price alerts with Telegram, and SEBI compliance. Multi-user OAuth with remote Streamable HTTP transport.
Updated 2 months ago (2026-06-14 19:17 UTC)
MIT
Angel One MCP Server
Finance Research & Data
RohanDoshi21
F
license
-
quality
D
maintenance
Enables interaction with Angel One trading APIs to retrieve historical market data and portfolio information.
Updated a year ago (2025-04-29 18:14 UTC)
10

View all related MCP servers

Related MCP Connectors

ShareSEER
Access SEC filings, insider transactions, and financial data via the ShareSEER API.
Banxico
Banxico MCP — Banco de México (Mexico's central bank) via the SIE API.
MCP Server for Zerodha Kite Connect API
Open-source MCP server for Zerodha Kite Connect. Portfolio, market data, backtesting, alerts.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/hackbansu/goldenpi-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server

GoldenPi Bonds MCP Server

Installation

Configuration

Running locally (stdio / OpenCode / Claude Desktop)

Running for ChatGPT / SSE clients

Tool reference

goldenpi_list_bonds

Pagination & sorting

Core filters

Boolean flags

Advanced filters

goldenpi_search_bonds

Testing

Legal / risks

Maintenance

Resources

Looking for Admin?

Related MCP Servers

Israeli Land Authority MCP

Tesouro Direto MCP Server

kite-mcp-server

Angel One MCP Server

Related MCP Connectors

Latest Blog Posts

MCP directory API

`goldenpi_list_bonds`

`goldenpi_search_bonds`