boe-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@boe-mcp what is the current Bank of England base rate?"
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.
boe-mcp
An MCP (Model Context Protocol) server that gives Claude Code — or any MCP client — live Bank of England data: the base rate (current level, change history, statistics over any period, and the rate in force on any past date), any series from the BoE's IADB statistical database (SONIA, exchange rates, quoted mortgage rates, and thousands more, with a curated catalog to start from), and the Monetary Policy Committee meeting schedule. It runs over stdio by default (with an opt-in Streamable HTTP mode for remote hosting), needs no API key or configuration, and caches responses in memory so repeated questions don't re-hit the BoE.

Published on npm as boe-mcp with build provenance — install and run it with npx -y boe-mcp.
Tools
Tool | Description | Example output |
| Current base rate, effective date, months held at this level |
|
| Last N rate changes (default 10) — date, rate, move in basis points vs previous ( |
|
| The base rate in force on a specific historical date |
|
| Summary statistics of the base rate over a date range (optional |
|
| Date of the next scheduled MPC announcement and days until it |
|
| All upcoming MPC announcement dates on the published schedule, each with days until it |
|
| Curated catalog of well-known IADB series (policy rates, market rates, FX, household rates) with code, name, description, unit and frequency — a starting point for |
|
| Fetch observations for any BoE IADB series by code, with optional |
|
get_series accepts any valid IADB code (not only the catalogued ones); an unknown or empty code returns a clean Unknown or empty IADB series "XXXX" — use list_series for known codes message. Use list_series to discover codes.
If the BoE is unreachable and a previously cached value exists, tools serve the cached data with "stale": true so the caller can flag the caveat. With no cache at all they return a clean error message.
Related MCP server: plinth-fx-mcp
Installation
Add to your Claude Code settings.json:
{
"mcpServers": {
"boe": {
"command": "npx",
"args": ["-y", "boe-mcp"]
}
}
}Or use the CLI:
claude mcp add boe -- npx -y boe-mcpAdd to claude_desktop_config.json:
{
"mcpServers": {
"boe": {
"command": "npx",
"args": ["-y", "boe-mcp"]
}
}
}Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"boe": {
"command": "npx",
"args": ["-y", "boe-mcp"]
}
}
}Add to .vscode/mcp.json:
{
"servers": {
"boe": {
"command": "npx",
"args": ["-y", "boe-mcp"]
}
}
}HTTP mode (remote hosting)
By default the server speaks MCP over stdio as a child process of the client. To host it remotely instead, start it in Streamable HTTP mode:
npx -y boe-mcp --http # listen on http://127.0.0.1:3000/mcp
npx -y boe-mcp --http 8080 # explicit port
BOE_MCP_HTTP_PORT=8080 npx -y boe-mcp # env var instead of the flagSetting | How | Default |
Enable HTTP mode |
| off (stdio) |
Port |
|
|
Bind host |
|
|
Endpoints: POST /mcp (JSON-RPC), GET /healthz (returns ok, for hosting platform health checks). The transport is stateless — every POST is served by a fresh server instance, so there are no sessions to resume and no SSE stream; GET/DELETE /mcp return 405. That makes instances safe to scale horizontally behind a load balancer.
Try it with curl:
curl -X POST http://127.0.0.1:3000/mcp \
-H 'content-type: application/json' \
-H 'accept: application/json, text/event-stream' \
-d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-03-26","capabilities":{},"clientInfo":{"name":"curl","version":"0"}}}'Security: the default bind of 127.0.0.1 only accepts connections from the local machine, and DNS-rebinding protection (Host-header validation) is enabled automatically for loopback binds. Setting BOE_MCP_HTTP_HOST=0.0.0.0 exposes the server, with no authentication, to every network the machine is attached to — only do that behind a reverse proxy or firewall that controls who can reach it (DNS-rebinding protection is disabled for non-loopback binds, since the server can't know the legitimate public hostname).
Configuration
Env var | Default | Description |
|
| How long to cache BoE responses in memory ( |
| unset | Enable HTTP mode on this port (see HTTP mode) |
|
| Bind host for HTTP mode — |
Data sources
Base rate: the Bank of England Statistical Interactive Database (IADB), series
IUDBEDR, via its public CSV endpoint. No auth, no key. Honest caveat: the IADB is not officially documented as a public API — it has been stable for many years and is widely used, but the Bank makes no compatibility promises, so a breaking change is possible in principle.MPC dates: parsed from the BoE's public upcoming MPC dates page. The parser deliberately avoids depending on the page's markup (it scans the visible text for dates), so cosmetic redesigns won't break it.
Running from source
git clone https://github.com/moureauf/boe-mcp.git
cd boe-mcp
npm install
npm run build
npm start # runs the stdio serverContributing & releasing
See CONTRIBUTING.md for the development workflow (making changes, testing, adding tools, versioning) and how the release pipeline connects GitHub, npm, and the MCP registry. Publishing is automated: pushing a v* tag runs .github/workflows/publish.yml, which builds, tests, and publishes to npm via trusted publishing (OIDC — no token secret, with a provenance attestation) and to the official MCP registry. Exact commands and one-time setup are in RELEASING.md.
License
MIT
Available Tools
8 toolsget_current_rateCurrent BoE base rateA
Get the current Bank of England base rate, the date it took effect, and how many whole months it has been held at this level.
Inputs: no named parameters. Returns: rate, stale, source, cachedAt, +2 more
get_mpc_datesUpcoming MPC announcement datesA
Get every upcoming Bank of England Monetary Policy Committee announcement date on the published schedule (typically a year or more ahead), each with the number of calendar days until it. Use get_next_mpc_meeting when only the next date is needed.
Inputs: no named parameters. Returns: dates, stale, source, cachedAt
get_next_mpc_meetingNext MPC meetingA
Get the date of the next scheduled Bank of England Monetary Policy Committee announcement and the number of days until it.
Inputs: no named parameters. Returns: date, stale, source, cachedAt, +1 more
get_rate_atBoE base rate on a dateA
Get the Bank of England base rate that was in force on a specific historical date, and when that level took effect.
Inputs: date (required). Returns: date, rate, stale, source, +2 more
get_rate_historyBoE base rate historyA
Get the last N Bank of England base rate changes: date, new rate, and the move in basis points vs the previous level (null for the earliest known entry).
Inputs: limit. Returns: stale, source, entries, cachedAt
get_rate_statsBoE base rate statistics over a rangeA
Get summary statistics of the Bank of England base rate over a date range: minimum and maximum (with the date each level first applied), the time-weighted average, and the rates in force at the start and end of the window with the net move in basis points. Both dates are optional — omit them for the full available history through today. The rate level in force on the start date counts even if it took effect earlier.
Inputs: to, from. Returns: to, max, min, from, +7 more
get_seriesGet a BoE IADB time seriesA
Fetch observations for any Bank of England IADB statistical series by its code (e.g. IUDSOIA for SONIA, XUDLUSS for USD/GBP). Optionally restrict to a date range and cap how many of the most recent points are returned. Use list_series to discover codes; any valid IADB code works, not only catalogued ones.
Inputs: seriesCode (required), to, from, limit. Returns: name, unit, stale, points, +4 more
list_seriesList known BoE IADB seriesA
List a curated catalog of well-known Bank of England IADB statistical series (policy rates, market rates, exchange rates, household rates) with their code, name, description, unit and frequency. Use this to discover series codes to pass to get_series. get_series also accepts any other IADB code, not only these.
Inputs: no named parameters. Returns: note, series
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose: current rate, historical rate, rate changes, rate statistics, next MPC meeting, all MPC dates, series discovery, and series data. The descriptions explicitly clarify boundaries, such as using get_next_mpc_meeting when only the next date is needed.
All tool names follow a consistent verb_noun pattern in snake_case (get_rate_at, get_next_mpc_meeting). The only non-get tool is list_series, which is a standard verb for collection listing and fits the pattern well.
8 tools is well-scoped for a Bank of England data server, covering base rate queries, MPC meeting schedules, and statistical series. There is no unnecessary overlap or bloat.
The tool set provides comprehensive coverage for its domain: full base rate lifecycle (current, history, at-date, stats), all MPC meeting dates (next and full schedule), and series discovery plus arbitrary data retrieval. No obvious gaps exist.
Maintenance
Related MCP Connectors
Bank of England Interactive Statistical Database (IADB) MCP.
One API and MCP server for financial and economic data: markets, economics, companies and more.
MCP server for live currency exchange rates and conversion, ISO codes and Chinese currency names.
MCP server for live currency exchange rates and conversion, ISO codes and Chinese currency names.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables querying Bank of England statistical data including Bank Rate, SONIA, and exchange rates via the IADB.93 npmMIT
- -licenseNot gradedqualityNot gradedmaintenanceMCP server that provides real exchange-rate data from the European Central Bank, including latest rates, currency conversion, historical rates, and time series.-
- AlicenseAqualityDmaintenanceAn MCP server that provides AI assistants with access to over 40 Bank of Japan statistical databases (interest rates, money supply, exchange rates, tankan, etc.) via the BOJ time-series data search API.49 npmMIT
- AlicenseNot gradedqualityBmaintenanceBanco Central do Brasil MCP server that enables querying Brazilian central bank economic indicators via SGS codes.89 npmMIT