Skip to main content
Glama

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)

  1. Visit openfiscaldata.go.kr

  2. Sign up / Log in

  3. My Page → Apply for OpenAPI

  4. Enter the issued key into .env

DATAGOKR_API_KEY (Optional)

  1. Visit data.go.kr

  2. Sign up / Log in

  3. My Page → Apply for API usage

  4. Enter the issued key into .env

NABOSTATS_API_KEY (Optional)

  1. Visit nabo.go.kr

  2. Sign up / Log in

  3. Apply for OpenAPI

  4. 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 build

Claude Desktop Configuration

Add the following to your Claude Desktop configuration file (claude_desktop_config.json).

Configuration File Location:

  • Windows: %APPDATA%\Claude\claude_desktop_config.json

  • macOS: ~/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 args path 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

fiscal_program

Search fiscal programs and execution status (Core)

fiscal_budget

Query budget proposals

fiscal_settlement

Query settlements

fiscal_ministry

Ministry fiscal status

fiscal_stats

Fiscal statistics (NABOSTATS)

discover_fiscal

Explore API catalog

query_fiscal

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 tools
fiscal_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.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.2/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    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.

    Completeness5/5

    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

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables AI to query real-time Korean public data including weather, real estate prices, air quality, economic indicators, and business registration via natural language.
      1
      MIT
    • A
      license
      A
      quality
      F
      maintenance
      Enables AI agents to search and analyze Korean macroeconomic statistics from the Bank of Korea's ECOS Open API through natural language.
      7
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT
    • A
      license
      Not graded
      quality
      A
      maintenance
      Enables 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 npm
      MIT