MCP-BRVM

Get the latest research data from the BRVM stock market (Bourse Régionale des Valeurs Mobilières — the UEMOA regional exchange).

This repository is a research-only Model Context Protocol server. Grok Bot can install it with AddMcpServer; agents such as The Wolf of BRVM can call quotes, issuer profiles, and history tools. There is no trade execution, order routing, or portfolio-advice feature.

Scope

Contract notes (not invented features):

• Official session quotes are EOD / last published table, not a guaranteed last-tick stream. The site often shows “Séance fermée” outside the Abidjan session.

• Prices are XOF (FCFA).

• get_issuer indexes /fr/emetteurs/societes-cotees and /fr/pays-societes-cotees/{country} cards, then fetches the issuer node. BRVM’s Drupal pager often repeats the same 10 issuers; country pages are the reliable live path. If no profile page matches, the tool returns quote-derived fields plus a notes[] explanation.

• Fixture mode ships a representative snapshot (SNTS and a short equity tape) so tools stay callable when live HTML flakes.

Related MCP server: BRVM MCP Server

Terms of use / reproduction risk

Research and personal alerting only. This server is not affiliated with BRVM SA, the AMF-UMOA, or Fredysessie.

Scraping www.brvm.org HTML is a medium–high Terms of Service / reproduction risk. The site publishes market data for human browsing; it does not offer a public machine API. Automated HTML collection can conflict with the site’s terms, robots policy, or copyright in the page markup. Use a polite User-Agent, prefer fixture mode for CI and development, cache live pages (this server uses a 5-minute in-memory TTL), and do not republish BRVM pages wholesale.

The OHLCV adapter reads CSVs already published on GitHub (raw.githubusercontent.com/Fredysessie/brvm-data-public). That archive is a third-party reproduction of BRVM history — treat it as unofficial and verify before any research conclusion.

Do not use this server to place, size, or justify trades. Outputs are observational market data for research agents.

Tools

Requirements

• Node.js 20+

• npm (or a compatible client)

Install and build

git clone https://github.com/LoicMessela/MCP-BRVM.git
cd MCP-BRVM
npm install
npm run build

npm run build compiles src/ to dist/. Fixtures stay in fixtures/ and are read from the package root at runtime.

Run

Default fixture mode (no live scrape). Stdio is the local MCP transport:

BRVM_DATA_MODE=fixture node dist/index.js

HTTP (Streamable HTTP at /mcp) for hosts that only accept a URL — including Grok Bot AddMcpServer:

BRVM_DATA_MODE=fixture node dist/index.js --http
# equivalent: MCP_TRANSPORT=http node dist/index.js

By default HTTP binds 127.0.0.1:8787. Override with MCP_HTTP_HOST, MCP_HTTP_PORT, and MCP_ALLOWED_HOSTS (comma-separated) when binding beyond localhost. Optional MCP_AUTH_TOKEN requires Authorization: Bearer <token> on /mcp.

GET /healthz is a process liveness URL (not an MCP tool).

Live vs fixture

BRVM_DATA_MODE=live node dist/index.js --http

Grok Bot — AddMcpServer

Grok Bot’s AddMcpServer form takes a name, a public HTTPS URL, and optional headers. It does not spawn a local stdio process. Host this server (or a tunnel to --http) so /mcp is reachable, then:

Name:     mcp-brvm
URL:      https://<your-host>/mcp
Headers:  Authorization: Bearer <MCP_AUTH_TOKEN>   # only if you set MCP_AUTH_TOKEN

Attach the connector to The Wolf of BRVM (or any research/alerts agent). Ask for quotes and history only — this package will not grow trading tools.

Local / terminal Grok (grok mcp add) can use stdio instead:

grok mcp add mcp-brvm -- node /absolute/path/to/MCP-BRVM/dist/index.js

Or HTTP:

grok mcp add --transport http mcp-brvm https://<your-host>/mcp

Cursor / other stdio hosts

{
  "mcpServers": {
    "mcp-brvm": {
      "command": "node",
      "args": ["/absolute/path/to/MCP-BRVM/dist/index.js"],
      "env": { "BRVM_DATA_MODE": "fixture" }
    }
  }
}

Smoke (proof)

After npm install and npm run build:

npm run smoke

This drives the official MCP client against createMcpHandler in process (no socket), with BRVM_DATA_MODE=fixture. It asserts that all five tools are registered and return structured results from the adapters.

Inspector (optional):

npx @modelcontextprotocol/inspector node dist/index.js

Layout

src/index.ts            stdio + HTTP entry
src/server.ts           createServer() + five tools
src/adapters/           brvm.org HTML, Fredysessie OHLCV
src/parse.ts            table / profile / CSV parsers
fixtures/               offline HTML + SNTS OHLCV

License

MIT (server code). Upstream market data remains the publishers’.