Here's the README formatted in proper markdown:
A Model Context Protocol (MCP) server implementation for accessing the Federal Reserve Economic Data (FRED) API. This server provides tools to search and retrieve economic data series from FRED.
- Node.js (v16 or higher)
- FRED API Key (obtain from FRED API)
-
Clone the repository:
git clone https://github.com/kablewy/fred-mcp-server cd fred-mcp-server -
Install dependencies:
npm install
-
Copy the
.env.examplefile to.envand add your FRED API key:FRED_API_KEY=your_api_key_here
Run the server in development mode:
npm run dev-
Build the project:
npm run build
-
Start the server:
npm start
The server provides the following FRED API tools:
Search for economic data series using various parameters.
Retrieve observations for a specific economic data series with options for:
- Date range filtering
- Frequency adjustment
- Aggregation methods
- Sorting and pagination
fred-mcp-server/
├── src/
│ ├── index.ts # Server entry point
│ ├── tools.ts # Tool implementations
│ └── types.ts # TypeScript interfaces
├── package.json
├── tsconfig.json
└── .env
Run the test suite:
npm test[Your chosen license]
[Your contribution guidelines]
- Built with Model Context Protocol SDK
- Data provided by Federal Reserve Economic Data (FRED)