fiscal-data MCP Server

README

Overview

The Fiscal Data MCP Server demonstrates a practical implementation of an MCP server that connects to the US Treasury's Fiscal Data API. It showcases:

Tools for fetching specific treasury statements
Resources for historical data access
Prompts for generating formatted reports

Quick Start

1. Install and Use with Claude Desktop

Add this configuration to your Claude Desktop config file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "fiscal-data": {
      "command": "npx",
      "args": ["fiscal-data-mcp"]
    }
  }
}

2. Example Interactions

Once configured, you can interact with the server through Claude:

Human: Can you get the treasury statement for the 20th of September 2023?

Features

1. Daily Treasury Statements

Fetch treasury data for specific dates using the get_daily_treasury_statement tool:

// Example usage through Claude
Human: Get the treasury statement for 2024-03-01
Assistant: I'll fetch that information for you using the treasury statement tool.

2. Historical Data Resource

Access 30 days of historical treasury data through the resource system:

Automatically cached for 1 hour
Updates on demand
Provides formatted JSON data

3. Report Generation

Generate formatted treasury reports using the daily_treasury_report prompt:

// Example usage through Claude
Human: Generate a treasury report for 2024-03-01
Assistant: I'll use the daily treasury report prompt to create a formatted report...

fiscal-data-mcp FAQ

How do I install the fiscal-data-mcp server?

Install by adding the fiscal-data-mcp configuration to your Claude Desktop config file and run it using 'npx fiscal-data-mcp'.

Can I use fiscal-data-mcp with other MCP clients besides Claude Desktop?

Yes, fiscal-data-mcp is compatible with any MCP client that supports standard MCP server connections.

What kind of data can I retrieve with fiscal-data-mcp?

You can retrieve daily treasury statements, historical fiscal data, and generate formatted reports from the US Treasury's Fiscal Data API.

Is the fiscal-data-mcp server real-time?

Yes, it fetches up-to-date treasury data directly from the US Treasury's Fiscal Data API.

Does fiscal-data-mcp support generating custom reports?

Yes, it includes prompts and tools to generate formatted financial reports based on the retrieved data.

What platforms are supported for running fiscal-data-mcp?

It runs on any platform supporting Node.js and MCP clients, including MacOS and Windows.

How secure is the data access through fiscal-data-mcp?

The server accesses publicly available US Treasury data via official APIs, ensuring secure and reliable data retrieval.

Can fiscal-data-mcp be extended to other fiscal data sources?

Yes, as an MCP server built with the mcp-framework, it can be extended or customized to connect to additional fiscal data APIs.