Turnleaf Analytics MCP Server

Description

Turnleaf Analytics provides an MCP server that gives Claude access to proprietary macroeconomic forecasts and Federal Reserve communications data. Users can query inflation, growth, and labor market forecasts across multiple countries, as well as retrieve and analyse Federal Reserve speeches, press statements, and meeting minutes with sentiment scoring.

Features

Setup

  1. Visit the Anthropic MCP Directory
  2. Find and connect to Turnleaf Analytics
  3. Enter your Turnleaf Analytics MCP token as the OAuth Client ID when prompted
  4. Complete the OAuth authentication flow by logging in with your Turnleaf Analytics account credentials
  5. Click Allow Access on the consent screen
  6. Claude will now have access to your Turnleaf Analytics data

Authentication

This server requires OAuth 2.0 authentication. You will need: - A valid Turnleaf Analytics account - An MCP token generated from your Turnleaf Analytics dashboard

Your MCP token acts as your OAuth Client ID. Each user has their own unique token. During the OAuth flow, you will be asked to log in with your Turnleaf Analytics email and password to confirm that the token belongs to you.

OAuth access tokens expire after 30 days. You will be prompted to re-authenticate when your token expires.

Examples

Note: Turnleaf Analytics data is continuously updated as new forecasts are published and new Federal Reserve events occur. The specific values shown in the examples below reflect the state of the data at the time of writing. When running the same prompts, results will differ depending on what the latest forecasts and events are.


Example 1: Get the most recent forecasts

User prompt: "What are the 5 most recent Turnleaf forecasts?"

Tool called: get_most_recent_forecasts with num_forecasts=5

Response:

The 5 most recent Turnleaf forecasts (as of 2026-03-05) are:

1. Switzerland – CPI MoM NSA (Inflation), forecast date: 2026-03-05
2. Switzerland – CPI YoY NSA (Inflation), forecast date: 2026-03-05
3. Switzerland – Core CPI MoM NSA (Inflation), forecast date: 2026-03-05
4. Switzerland – Core CPI YoY NSA (Inflation), forecast date: 2026-03-05
5. United States – ISM Non Manufacturing Index SA (Growth), forecast date: 2026-03-05

Example 2: Filter forecasts by country and category

User prompt: "Show me the latest US inflation forecasts."

Tool called: get_most_recent_forecasts_with_filters with country="United States", category="Inflation", num_forecasts=5

Response:

The 5 most recent US Inflation forecasts are:

1. Core Goods CPI YoY SA – nowcast, forecast date: 2026-03-04
2. Core Services CPI MoM SA – nowcast, forecast date: 2026-03-04
3. Core Services CPI YoY SA – nowcast, forecast date: 2026-03-04
4. CPI MoM NSA (no benchmark) – nowcast, forecast date: 2026-03-05
5. CPI YoY NSA (no benchmark) – nowcast, forecast date: 2026-03-05

Example 3: Get individual forecast data

User prompt: "Get me the full forecast data for US CPI YoY for the forecast made on 2026-03-05."

Tool called: get_individual_forecast_data with country="United States", indicator="CPI YoY NSA (no benchmark)", forecast_date="2026-03-05"

Response:

Turnleaf's US CPI YoY forecast (made 2026-03-05):

Near-term (Feb 2026): Model = 2.43%, Upper CB = 2.68%, Lower CB = 2.27%
  Benchmark (Philly Fed / EIA): 2.08%

Mar 2026: Model = 2.81%, Market = 2.80%
Apr 2026: Model = 2.82%, Market = 2.99%
...continuing through Jan 2027 where Model = 3.10%

Key Shapley drivers for Feb 2026:
  - Base effect: +1.93
  - Seasonal: +0.15
  - Consumer prices: +0.04
  - Output/business activity: +0.02

Example 4: Plot a forecast chart

User prompt: "Plot the US CPI YoY forecast from 2026-03-05."

Tool called: plot_individual_forecast_data with country="United States", indicator="CPI YoY NSA (no benchmark)", forecast_date="2026-03-05"

Response: Returns a chart image showing the model forecast, confidence bands, benchmark, and realised values across all tenors.


Example 5: Get the most recent Fed events

User prompt: "What are the 3 most recent Federal Reserve events?"

Tool called: get_events with num_events=3, fields=["date", "speakers", "event_type", "title", "cscore", "bank_name"]

Response:

The 3 most recent Fed events (as of 2026-03-05):

1. 2026-03-03 – Vice Chair Bowman (FED Reserve)
   Speech: "Liquidity Resiliency, Financial Stability, and the Role of the Federal Reserve"
   CScore: -0.04

2. 2026-03-03 – Pres. Schmid (FED Kansas City)
   Speech: "The Economic Outlook and Monetary Policy"
   CScore: -0.45

3. 2026-03-03 – Pres. Kashkari (FED Minneapolis)
   Video: "Conversation with Neel Kashkari at the 2026 Bloomberg Invest Conference"
   CScore: N/A

Example 6: Filter Fed events by speaker

User prompt: "Show me the last 3 speeches by Pres. Schmid."

Tool called: get_events_filtered with speaker="Pres. Schmid", num_events=3, fields=["date", "speakers", "event_type", "title", "cscore"]

Response:

Last 3 events by Pres. Schmid (FED Kansas City):

1. 2026-01-15 – "The Economic Outlook and Monetary Policy", CScore: +0.10
2. 2026-02-11 – "Monetary Policy and the Economic Outlook", CScore: +0.89
3. 2026-03-03 – "The Economic Outlook and Monetary Policy", CScore: -0.45

Example 7: Retrieve full text of a single event

User prompt: "Get the full text of Pres. Schmid's speech from March 3rd, 2026."

Tool called: get_single_event with url_code="20260303_https___www_kansascityfed_org__speeches_the_economic_outlook_and_monetary_policy_march_2026_"

Response: Returns the full transcript (15,551 characters) of the speech delivered to the Metro Denver Executive Club. The speech covers the economic outlook, inflation running near 3%, labor market slowdown, demographic transitions, and the Fed's dual mandate stance.


Example 8: Find the most hawkish/dovish recent speeches

User prompt: "Show me the most hawkish recent Fed speeches, i.e. those with the highest CScore."

Tool called: get_events_filtered with cscore_min=0.5, num_events=3, fields=["date", "speakers", "event_type", "title", "cscore", "bank_name"]

Response:

Most positive CScore speeches (cscore ≥ 0.5):

1. Gov. Cook (FED Reserve), 2026-02-24
   "Opening Remarks for the AI and Productivity across the Economy Panel"
   CScore: +1.18

2. Gov. Waller (FED Reserve), 2026-02-24
   "Operationalizing AI at the Federal Reserve"
   CScore: +0.53

3. Pres. Bostic (FED Atlanta), 2026-02-25
   "Farewell to the Best Job I've Ever Had"
   CScore: +2.03

Example 9: Get the latest US labor market forecasts

User prompt: "What are the latest US labor market forecasts?"

Tool called: get_most_recent_forecasts_with_filters with country="United States", category="Labor", num_forecasts=3

Response:

Latest US Labor forecasts:

1. Unemployment Rate SA – forecast date: 2026-02-13 (non-nowcast)
2. NFP Change SA – nowcast, forecast date: 2026-03-03
3. Unemployment Rate SA – nowcast, forecast date: 2026-03-03

Privacy Policy

See our privacy policy: https://turnleafanalytics.com/privacy-policy/

Support