Skip to main content
Glama
Japan Area Code MCP Server

Japan Area Code MCP Server

by CORDEA

Japan Area Code MCP Server

A Model Context Protocol (MCP) server that provides access to Japanese statistical standard area codes (標準地域コード). This server fetches data from the official Japanese government CSV file and provides tools to list and search area codes.

Installation

  1. Clone or download this repository

  2. Install dependencies:

    npm install
  3. Build the project:

    npm run build

Related MCP server: jpzip MCP server

Configuration

To use this MCP server with Cursor or other MCP-compatible clients, add it to your MCP configuration file (typically ~/.cursor/mcp.json):

{
    "mcpServers": {
        "japan-areacode-mcp": {
            "command": "node",
            "args": ["/path/to/japan-areacode-mcp/dist/index.js"]
        }
    }
}

Make sure to replace /path/to/japan-areacode-mcp with the actual path to this project.

Usage

The server provides two tools: list-areacode and find-areacode

Tool: list-areacode

Lists all area codes from the official Japanese government CSV file.

Parameters

None

Tool: find-areacode

Finds an area code by searching for a prefecture or municipality name.

Parameters

Parameter

Type

Required

Description

query

string

Yes

Search query that can match prefecture name, municipality name, or yomigana

References

Available Tools

2 tools
find-areacodeA

Find the area code of a given prefecture

Inputs: query (required). Returns: data

list-areacodeA

List all area codes

Inputs: no named parameters. Returns: data

Tool Schema Changelog

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

Loading tool schema changelog…

    TDQS

    A3.9/5.0

    Scored across 2 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: one retrieves a specific area code given a prefecture, the other lists all area codes. No ambiguity or overlap exists.

    Naming Consistency5/5

    Both tools follow a consistent verb-areacode pattern using lowercase with hyphens (find-areacode, list-areacode), making them predictable and easy to interpret.

    Tool Count4/5

    With only two tools, the scope is narrow but appropriate for a read-only area code lookup service. It could potentially include a reverse lookup, but the count is reasonable for the stated purpose.

    Completeness4/5

    The tool set covers the essential operations for area codes: querying a specific prefecture and listing all. A minor gap is the lack of a search-by-code function, but the basic use cases are addressed.

    Maintenance

    ActivityInactive
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      C
      quality
      B
      maintenance
      Enables access to Japan's official government statistics portal (e-Stat) API to search, retrieve, and analyze statistical data including census data, economic indicators, and demographic information across 17 statistical fields.
      13
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Enables to look up Japanese postal codes, convert zipcodes to addresses, search addresses by query, and list cities in a prefecture using the jpzip dataset.
      4
      7 npm
      MIT
    • A
      license
      B
      quality
      C
      maintenance
      Enables read-only search of indicator names to find series codes and retrieval of statistical values by series code, optionally filtered by region and period, through Japan's Statistics Dashboard API.
      2
      MIT