fiscal-api-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., "@fiscal-api-mcp 2024년 교육부 예산이 얼마야?"
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.
fiscal-api-mcp
National Fiscal API MCP Server — Provides budget, settlement, and fiscal program data to AI agents.
Data Sources
Source | Content | Required Key |
openfiscaldata.go.kr | Fiscal programs, budgets, settlements, ministry status | OPENFISCAL_API_KEY (Required) |
data.go.kr | Budget status by sector/ministry | DATAGOKR_API_KEY (Optional) |
nabostats.go.kr | Fiscal aggregates, tax burden ratio, national debt | NABOSTATS_API_KEY (Optional) |
Related MCP server: ECOS MCP Server
API Key Issuance
OPENFISCAL_API_KEY (Required)
Visit openfiscaldata.go.kr
Sign up / Log in
My Page → Apply for OpenAPI
Enter the issued key into
.env
DATAGOKR_API_KEY (Optional)
Visit data.go.kr
Sign up / Log in
My Page → Apply for API usage
Enter the issued key into
.env
NABOSTATS_API_KEY (Optional)
Visit nabo.go.kr
Sign up / Log in
Apply for OpenAPI
Enter the issued key into
.env
Quick Start
git clone https://github.com/yangheeseok1/fiscal-api-mcp
cd fiscal-api-mcp
npm install
cp .env.example .env
# .env 파일을 열어 API 키 입력
npm run buildClaude Desktop Configuration
Add the following to your Claude Desktop configuration file (claude_desktop_config.json).
Configuration File Location:
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonmacOS:
~/Library/Application Support/Claude/claude_desktop_config.json
{
"mcpServers": {
"fiscal-api-mcp": {
"command": "node",
"args": ["C:/경로/fiscal-api-mcp/dist/index.js"],
"env": {
"OPENFISCAL_API_KEY": "your_key_here",
"DATAGOKR_API_KEY": "your_key_here",
"NABOSTATS_API_KEY": "your_key_here"
}
}
}
}Change the
argspath to your actual project path. If you do not have the optional keys (DATAGOKR_API_KEY,NABOSTATS_API_KEY), you may delete those lines.
Restart Claude Desktop after configuration to activate the tools.
Tools (7)
Tool | Description |
| Search fiscal programs and execution status (Core) |
| Query budget proposals |
| Query settlements |
| Ministry fiscal status |
| Fiscal statistics (NABOSTATS) |
| Explore API catalog |
| Direct API call |
Usage Examples
You can ask questions in natural language in Claude Desktop as shown below.
2024년 교육부 예산이 얼마야?
R&D 재정사업 집행현황 보여줘
2015년부터 2024년까지 국가채무 추이 알려줘
기재부 소관 재정사업 목록 뽑아줘
2023년 세출결산에서 집행률이 가장 낮은 부처는?Available Tools
3 toolsfiscal_guideA
열린재정 OpenAPI 전체 카탈로그(157개)를 카테고리별로 안내합니다. category 없이 호출하면 카테고리 요약을 반환합니다. category를 지정하면 해당 카테고리의 전체 API 목록(코드·이름·필수파라미터)을 반환합니다. 데이터를 찾을 때: fiscal_guide → fiscal_search → fiscal_query 순서로 사용하세요.
Inputs: category.
fiscal_queryB
열린재정 API를 호출해 데이터를 조회합니다. api_code는 fiscal_search 또는 fiscal_guide로 먼저 확인하세요. page_size 기본값은 100입니다 (최대 1000).
Inputs: api_code (required), params, page, page_size.
fiscal_searchA
키워드 또는 카테고리로 열린재정 API를 검색합니다. 검색 결과에서 code를 확인한 뒤 fiscal_query로 데이터를 호출하세요. 예: fiscal_search(keyword="국가채무") → code 확인 → fiscal_query(api_code=..., params={...})
Inputs: keyword, category.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool has a clear, distinct purpose: fiscal_guide for catalog navigation, fiscal_search for finding APIs, and fiscal_query for data retrieval. The documentation explicitly specifies the recommended order of use, eliminating ambiguity.
All names use snake_case with a consistent 'fiscal_' prefix, following a verb-like pattern (guide, search, query). Slight deviation: 'fiscal_guide' is more noun-like than verb-like, but overall pattern is coherent.
Three tools is perfectly scoped for a data API server: one for exploration, one for search, and one for direct query. Each tool serves a necessary function without redundancy.
The tool set covers the full workflow from discovering APIs (guide), to finding specific endpoints (search), to fetching data (query). There are no obvious gaps for the stated purpose of accessing the 열린재정 OpenAPI.
Maintenance
Related MCP Connectors
Korean company facts in English for AI agents: ~830 KOSPI-listed companies (DART profiles, KRW financials, recent filings) and ~110,000 corporate public procurement suppliers (12-month KONEPS contract awards), plus live National Tax Service business status checks. 4 tools, keyless, read-only.
Korean fact-verification tools for AI agents: business registration, address, DART, apt prices, laws
US government data as clean JSON for AI agents: SAM.gov contract opportunities, USAspending awards, Grants.gov grants, House STOCK Act trades, and SEC EDGAR filings (Form 4 insider trades, 8-K events, 13F holdings, 13D/G stakes, XBRL fundamentals, 10-K/10-Q sections). 19 read-only tools. Data is as fresh as each source publishes; congressional trades lag up to 45 days and report dollar ranges (House only). Free tier, no card.
Korean policy & finance facts with primary-source citations (laws, gov notices) for AI agents
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI to query real-time Korean public data including weather, real estate prices, air quality, economic indicators, and business registration via natural language.1MIT
- AlicenseAqualityFmaintenanceEnables AI agents to search and analyze Korean macroeconomic statistics from the Bank of Korea's ECOS Open API through natural language.7MIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to query Korean OpenDART disclosure, financial, ownership, and XBRL data through 15 tools, including insider signals, accounting-risk scoring, Buffett-style quality checklists, and HWP/PDF attachment conversion to Markdown.545 npmMIT
- AlicenseNot gradedqualityAmaintenanceEnables AI assistants to query Korean OpenDART electronic disclosure data — disclosures, financials, equity, and XBRL — through 15 consolidated tools, including insider-trading signals, accounting-risk scoring, Buffett-style quality checklists, and HWP/PDF attachment-to-Markdown conversion.545 npmMIT