cbn_mcp

The CBN MCP Server provides programmatic access to Central Bank of Nigeria (CBN) data and circulars through the Model Context Protocol (MCP). It exposes tools organized by domain, including Circulars, Exchange Rates, and Financial Data, as well as helper resources and prompts to facilitate analysis in AI assistants. You can connect this server to Cursor, Claude Desktop, or any MCP-compatible application to query latest circulars, fetch PDFs, retrieve exchange rates, and obtain financial metrics, all via structured MCP endpoints. Typical workflows include asking for the latest circulars, retrieving details by ID, downloading PDFs for offline reading, or performing higher-level prompts for regulatory analysis and summaries. Tools are designed to be self-descriptive, with clear actions such as getAllCirculars, getCircularById, fetchCircularPdf, getAllExchangeRates, getFinancialDataById, and status/prompts endpoints for integrated AI experiences.

Prerequisites:

• Dart SDK ^3.9.2
• Git

Option A: Install and run a pre-built binary

1. Download the latest pre-built binary cbn_mcp from the Releases page.
2. Make it executable (on Unix-like systems): chmod +x cbn_mcp
3. Run the server directly: ./cbn_mcp

Option B: Run from source with Dart

1. Clone the repository: git clone https://github.com/chiziaruhoma/cbn_mcp.git
2. Navigate into the project: cd cbn_mcp
3. Install dependencies: dart pub get
4. Run the server: dart run bin/main.dart

Option C: Build from source to a standalone executable

1. Follow Option B steps 1-3
2. Build: dart compile exe bin/main.dart -o cbn_mcp
3. Run the executable: ./cbn_mcp

Tips and notes:

• The server exposes endpoints under the MCP framework; use the provided prompts and tool names to construct queries.
• If you’re using a pre-built binary, ensure the path in your MCP client configuration points to the executable and that it has execute permissions.
• When integrating with Claude Desktop or Cursor, the configuration should specify either the binary path or a Dart run configuration with the appropriate working directory (cwd).
• For Dart development, you may need to run dart pub get after cloning, and you can generate additional mappable classes with dart run build_runner build if your setup requires it.
• The API documentation references the Central Bank of Nigeria public API; consult the CBN Developer Portal for endpoint specifics and rate limits.