Transcode

io.github.hiroshic9-pngPublished by GitHub account hiroshic9-pngv1.0.1Updated Oct 24, 2026

Japan market intelligence — 22 MCP tools, 10 government/exchange data sources

VerifiedSTDIODesktop onlyWeb Search & ScrapingFinanceData & Analytics

Overview

AI-generated overview

Gives an assistant 22 tools for Japanese market intelligence, covering disclosures, corporate data, government statistics, macro indicators, weather and…

What you can do
The server exposes tools such as japan_briefing, company_intelligence, market_snapshot, get_disclosures, financials, stock_prices, government_stats, tankan, investor_flows and interpret. These aggregate Japanese public data — TDnet disclosures, EDINET holdings, gBizINFO company records, e-Stat statistics, J-Quants market data, FRED, BOJ Tankan, JPX flows, weather and earthquake feeds — into structured responses, with an AI interpretation layer. It is a thin client that calls a hosted REST backend.
When to use it
Useful when an assistant needs Japanese equity, corporate or macroeconomic context: daily market briefings, cross-source company analysis, disclosure monitoring, or macro and policy summaries. Not intended for non-Japanese markets or for data outside the listed sources.
Requirements
Runs locally over stdio as the npm package transcode-mcp-server, so Node.js is needed. Requires the environment variables JAPAN_INTELLIGENCE_API_URL (backend endpoint) and JI_API_KEY (secret API key, requested at transcode.sh). Network access to the backend is required; the backend rate-limits to 100 requests per hour per key.
Before you install
The JI_API_KEY secret is sent to the hosted backend, and all queries and results pass through that third party. The backend itself needs its own upstream credentials (EDINET_API_KEY, GEMINI_API_KEY, GBIZ_API_TOKEN, ESTAT_APP_ID, JQUANTS_API_KEY, FRED_API_KEY) if self-hosted. Tools are read-only lookups, but the interpret tool sends data to a Gemini-based interpretation layer.

Installation

In SourceWeft

  1. Open Transcode in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

Japan Intelligence API

AIエージェントのための日本市場インテリジェンス基盤

Japan Intelligence は、日本の公開情報を構造化し、AIエージェントが即座に利用可能な形式で提供するAPIプラットフォームです。14のデータソースを横断統合し、企業分析・マクロ経済・金融政策・環境災害を49エンドポイント + 27 MCPツールで完結させます。

🎯 1つのAPIキーで日本の全て — 適時開示、機関投資家の持分変動、500万法人のデータベース、政府統計10系列、株価ヒストリカル、日銀短観、投資部門別売買動向、日米金融政策、天気予報、地震データ、経済カレンダー、AI解釈を統合提供

Architecture

┌──────────────────────────────────────────────────────────────────┐│                    AI Agent (Claude, Cursor, etc.)                ││                          ↓ MCP (22 tools)                        ││              ┌──────────────────────────────┐                    ││              │   MCP Server (22 tools)       │                   ││              └──────────────┬───────────────┘                    ││                             ↓ REST API (35 endpoints)            ││  ┌──────────────────────────────────────────────────────────┐    ││  │              Japan Intelligence API (FastAPI)             │    ││  │                                                          │    ││  │  Layer 2: AI Interpretation (Gemini 2.5 Flash)           │    ││  │  Layer 1: Structured Data + Cache-Control (per-source)   │    ││  │                                                          │    ││  │  ┌─────┐ ┌──────┐ ┌────────┐ ┌──────┐ ┌────────┐       │    ││  │  │TDnet│ │EDINET│ │gBizINFO│ │e-Stat│ │J-Quants│       │    ││  │  └─────┘ └──────┘ └────────┘ └──────┘ └────────┘       │    ││  │  ┌────┐ ┌───┐ ┌───┐ ┌─────┐ ┌───────────┐              │    ││  │  │FRED│ │BOJ│ │JPX│ │Macro│ │Interpreter│               │    ││  │  └────┘ └───┘ └───┘ └─────┘ └───────────┘              │    ││  └──────────────────────────────────────────────────────────┘    │└──────────────────────────────────────────────────────────────────┘

Data Sources (14)

#SourceDataCoverage
1TDnet適時開示 — 業績修正、M&A、自社株買い、配当等15カテゴリ自動分類全上場企業
2EDINET大量保有報告書 — 機関投資家の持分変動（5%超）全上場企業
3gBizINFO企業情報 — 補助金、認定、特許、財務、調達500万法人
4e-Stat政府統計10系列 — GDP、CPI、失業率、鉱工業生産、小売、景気ウォッチャー、家計調査、貿易統計日本経済全体
5J-Quants市場データ — 全銘柄マスタ、決算、財務、株価ヒストリカル（OHLCV + 移動平均）、セクター分析全上場銘柄
6FRED日米マクロ — 金利、CPI、雇用、為替、VIX（10系列）米国+日本
7BOJ日銀短観 — 業況判断DI（大企業/中小×製造業/非製造業＋設備投資計画）四半期更新
8JPX投資部門別売買動向 — 外国人、個人、信託銀行、事業法人（9部門構造化）週次
9Macroリアルタイム指標 — 原油、金、ドル円、VIX、日経、S&P + 異常変動検知6指標
10AIGemini 2.5 Flash による構造化データ解釈（Layer 2）全データ
11The社史上場企業253社の創業〜現在の社歴主要上場企業
12Open-Meteo天気予報（JMAモデル） — 8主要都市 + ビジネスインパクト判定東京〜那覇
13USGS地震データ — 日本周辺M3+、セクター影響分析、津波警報日本全域
14Calendar経済カレンダー — BOJ会合、短観、GDP、CPI、決算、休場日2026年

Key Endpoints (44)

Intelligence — 1コールで全て把握

bash
# 日本全体ブリーフィング（朝の第一手）★ GET /api/v1/briefing
# 企業インテリジェンス — 6軸分析（プロフィール+財務+株価+開示+保有+マクロ）★GET /api/v1/intelligence/{ticker}
# マーケットスナップショット — 市場全体 + 投資部門別フロー + セクター概況GET /api/v1/market/snapshot
# 開示統計 — 市場の温度感GET /api/v1/disclosures/stats

Corporate Data

bash
GET /api/v1/company/{id}              # 企業プロフィールGET /api/v1/company/{id}/patents      # 特許ポートフォリオGET /api/v1/company/{id}/subsidies    # 補助金実績GET /api/v1/company/{id}/certifications # 認定情報GET /api/v1/company/{id}/finance      # 財務データGET /api/v1/company/search?name=ソニー # 企業名検索GET /api/v1/disclosures               # 適時開示一覧GET /api/v1/disclosures/{ticker}      # 銘柄別開示GET /api/v1/holdings                   # 大量保有報告GET /api/v1/holdings/{ticker}          # 銘柄別大量保有

Market & Financials

bash
GET /api/v1/financials/{ticker}  # 財務サマリー（売上・利益・EPS・予想）GET /api/v1/stocks               # 全上場銘柄マスタGET /api/v1/earnings             # 決算カレンダーGET /api/v1/prices/{ticker}      # 株価ヒストリカル（OHLCV + MA5/25/75 + 騰落率）★NEWGET /api/v1/sectors              # セクター分析（17/33業種 + 市場区分別構成）★NEW

Government Statistics & Global Macro

bash
GET /api/v1/stats/series         # 利用可能統計系列一覧GET /api/v1/stats/summary        # マクロ統計サマリー（1コール）GET /api/v1/stats/{series_id}    # 個別統計（gdp, cpi, unemployment等10系列）GET /api/v1/stats/search/{kw}    # 統計検索GET /api/v1/global/series        # FRED系列一覧GET /api/v1/global/policy        # 日米金融政策サマリー（1コール）GET /api/v1/global/{series_key}  # FRED個別系列GET /api/v1/tankan               # 日銀短観サマリーGET /api/v1/tankan/{series_id}   # 短観個別系列GET /api/v1/tankan/series/list   # 短観系列一覧GET /api/v1/investor-flows       # 投資部門別売買動向（9部門構造化）

Macro & Events

bash
GET  /api/v1/macro               # マクロ6指標GET  /api/v1/macro/events        # 異常変動検知 + 恩恵/逆風銘柄POST /api/v1/interpret           # AI解釈（Layer 2）GET  /api/v1/ticker/{ticker}     # 銘柄名解決GET  /api/v1/health              # ヘルスチェック

Environment & Disaster

bash
GET /api/v1/weather              # 日本8都市の天気予報（ビジネスインパクト判定付き）GET /api/v1/weather/cities       # 利用可能な都市一覧GET /api/v1/earthquakes          # 日本周辺の地震データ（セクター影響分析付き）GET /api/v1/calendar             # 経済カレンダー（BOJ会合・短観・GDP・CPI・決算・休場日）GET /api/v1/calendar/holidays    # 東証休場日GET /api/v1/calendar/categories  # カレンダーカテゴリ一覧

Response Caching

ソース特性別に最適化されたHTTPキャッシュ：

SourceCache-Control max-age理由
TDnet5分リアルタイム性重視
Macro5分リアルタイム性重視
Intelligence10分複合ソース
FRED1時間高頻度参照
e-Stat6時間月次更新
BOJ6時間四半期更新
EDINET6時間日次更新
J-Quants12時間日次更新
JPX12時間週次更新
gBizINFO24時間低頻度更新

ETag対応（304 Not Modified）、stale-while-revalidate対応。

Authentication

All endpoints (except /docs, /redoc, /health) require API key authentication:

bash
# Header authentication (recommended)curl -H "X-API-Key: YOUR_API_KEY" https://japan-intelligence-api.onrender.com/api/v1/briefing
# Bearer tokencurl -H "Authorization: Bearer YOUR_API_KEY" https://japan-intelligence-api.onrender.com/api/v1/briefing
# Query parametercurl "https://japan-intelligence-api.onrender.com/api/v1/briefing?api_key=YOUR_API_KEY"

Rate limit: 100 requests/hour per API key (X-RateLimit-Limit/Remaining headers).

MCP Server (27 tools for AI Agents)

CategoryToolDescription
Intelligencejapan_briefing🌟 Daily briefing — market, policy, tankan, sentiment, investor flows
market_snapshotMarket overview — macro + events + disclosures + investor flows + sectors
company_intelligence🌟 Cross-source 6-axis company analysis (profile + financials + stock price + disclosures + holdings + macro)
disclosure_statsDisclosure statistics — sentiment gauge
Marketget_disclosuresTDnet corporate disclosures with impact assessment
get_macro6 key macro indicators (Nikkei, USD/JPY, VIX, etc.)
detect_eventsMacro anomaly detection with stock mapping
Companycompany_profilegBizINFO full company data (patents, subsidies, etc.)
company_searchSearch 5M+ corporations
financialsJ-Quants financial statements with forecasts
listed_stocksAll listed stocks master
earnings_calendarUpcoming earnings dates
stock_prices🆕 Stock price history with MA5/25/75 + daily/weekly/monthly changes
sector_summary🆕 Market structure — 17/33 sector classifications + market segment distribution
Economicsgovernment_statse-Stat 10 series (GDP, CPI, economy watchers, trade, etc.)
stats_summaryMacro statistics summary (1 call)
global_macroFRED US + Japan macro (rates, CPI, FX, VIX)
policy_summaryUS-Japan monetary policy summary (1 call)
tankanBOJ Tankan business sentiment DI
investor_flowsJPX weekly investor flow data (9 categories with directional signals)
Utilitylookup_tickerTicker → company name resolution
interpretAI interpretation (Layer 2, Gemini 2.5)

Claude Desktop / Cursor Configuration

json
{  "mcpServers": {    "japan-intelligence": {      "command": "node",      "args": ["/path/to/mcp-server/dist/index.js"],      "env": {        "JAPAN_INTELLIGENCE_API_URL": "https://japan-intelligence-api.onrender.com",        "JI_API_KEY": "YOUR_API_KEY"      }    }  }}

Framework Integration (LangChain / CrewAI)

LangChain

python
from integrations.transcode_langchain import get_transcode_toolsfrom langchain_openai import ChatOpenAIfrom langgraph.prebuilt import create_react_agent
tools = get_transcode_tools(api_key="your-api-key")llm = ChatOpenAI(model="gpt-4o")agent = create_react_agent(llm, tools)
result = agent.invoke({    "messages": [("user", "What's happening in Japanese markets today?")]})

11 tools: japan_briefing, company_intelligence, market_snapshot, disclosures, ai_summarized_disclosures, holdings, investor_flows, macro_events, tankan_summary, economic_calendar, batch_intelligence

CrewAI

python
from integrations.transcode_crewai import TranscodeToolsfrom crewai import Agent, Task, Crew
tools = TranscodeTools(api_key="your-api-key")
analyst = Agent(    role="Japan Market Analyst",    goal="Analyze Japanese market conditions and identify opportunities",    tools=tools.all(),  # 9 tools, or tools.core() for 4 essentials)
task = Task(    description="Create a morning briefing on Japanese markets",    expected_output="Structured market report with key takeaways",    agent=analyst,)
crew = Crew(agents=[analyst], tasks=[task])result = crew.kickoff()

Standalone (No Framework)

python
from integrations.transcode_langchain import TranscodeClient
client = TranscodeClient(api_key="your-api-key")briefing = client.briefing()intel = client.intelligence("7203")  # Toyota

Batch API (Developer/Pro)

bash
# Multi-ticker intelligencePOST /api/v1/batch/intelligence   {"tickers": ["7203", "6501", "9984"]}
# Multi-ticker disclosuresPOST /api/v1/batch/disclosures    {"tickers": ["7203", "6501"], "days": 3}
# Bulk ticker resolutionPOST /api/v1/batch/tickers        {"tickers": ["7203", "6501", "9984"]}

AI-Summarized Disclosures (Exclusive)

bash
# English AI summaries + impact scoring for all disclosuresGET /api/v1/disclosures/summarized?days=3&min_impact=3

Returns:

json
{  "ai_summary": {    "summary_en": "Share buyback announced by Toyota, signals undervaluation view",    "impact_score": 4,    "sector_relevance": "Automotive, Manufacturing",    "source": "gemini"  }}

Telemetry

bash
GET /api/v1/telemetry/today       # Today's API usage statsGET /api/v1/telemetry/history     # Historical usage (7 days default)

Quick Start

bash
# 1. Clonegit clone https://github.com/hiroshic9-png/japan-intelligence-api.gitcd japan-intelligence-api
# 2. Setuppython -m venv venv && source venv/bin/activatepip install -r requirements.txt
# 3. Configurecp .env.example .env# Edit .env with your API keys
# 4. Runpython -m api.main# → http://localhost:8080/docs

Environment Variables

VariableRequiredDescription
EDINET_API_KEYYesEDINET disclosure API key
GEMINI_API_KEYYesGoogle Gemini API key (Layer 2 interpretation)
GBIZ_API_TOKENYesgBizINFO API token
ESTAT_APP_IDYese-Stat application ID
JQUANTS_API_KEYYesJ-Quants v2 API key
FRED_API_KEYYesFRED API key
JI_API_KEYOptionalAPI authentication key (enables auth when set)
JI_API_KEYSOptionalMulti-tier keys: {"key": "tier"}

API Documentation

Interactive documentation:

License

Proprietary. All rights reserved.

Source: README.md at commit 54d761c

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v1.0.1LatestSep 16, 2026

Score

40% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

    Declare a license in the repository or the registry entry.