Bango API(法人番号・インボイス)
Look up Japanese companies by name, corporate number or invoice T-number
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 0.1.0
- Listing updated
- 3 days ago
About Bango API(法人番号・インボイス)
Bango API(法人番号・インボイス) is a freemium MCP server for analytics and data. It runs locally on your machine and is started by your AI client.
Built on Japan's National Tax Agency corporate-number and qualified-invoice data, this server lets an assistant answer questions such as whether a T-number was valid on a given past date, or what the registered head-office address of a company is. Name search tolerates variations such as 株式会社 versus ㈱, full-width versus half-width characters, and numbers with hyphens. When several candidates match, it is designed to ask the user instead of picking one.
The bulk tools help with clean-up work: check up to 20 invoice numbers in one call, or match a list of up to 50 company names to corporate numbers, with confident matches separated from ones needing review. All four tools are read-only.
It runs locally over stdio through npx and needs Node.js 20 or later plus a Bango API key. New sign-ups get a 30-day Pro trial without a card, then move to a Free plan of 500 API calls and 50 matches a month. The README notes the data is processed from NTA sources and not guaranteed by the agency.
Install
Run in a terminal
claude mcp add bango-mcp --env BANGO_API_KEY='<BANGO_API_KEY>' -- npx -y bango-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"bango-mcp": {
"command": "npx",
"args": [
"-y",
"bango-mcp"
],
"env": {
"BANGO_API_KEY": "<BANGO_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"bango-mcp": {
"command": "npx",
"args": [
"-y",
"bango-mcp"
],
"env": {
"BANGO_API_KEY": "<BANGO_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"bango-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"bango-mcp"
],
"env": {
"BANGO_API_KEY": "<BANGO_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"bango-mcp": {
"command": "npx",
"args": [
"-y",
"bango-mcp"
],
"env": {
"BANGO_API_KEY": "<BANGO_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"bango-mcp": {
"command": "npx",
"args": [
"-y",
"bango-mcp"
],
"env": {
"BANGO_API_KEY": "<BANGO_API_KEY>"
}
}
}
}Configuration
BANGO_API_KEYBango API key (free plan available at https://bango-api.jp/signup)Required
Tools this server provides (4)
Taken from the project documentation; the running server may differ.
- bango_find_company
- Find companies by name, filterable by prefecture or postcode
- bango_get_company
- Get company details and invoice status by corporate number or T-number
- bango_check_invoice
- Check T-number validity, up to 20 at once, optionally as of a date
- bango_match_companies
- Match up to 50 company names to corporate numbers
What it does
- Fuzzy name search
- Finds companies despite 株式会社/㈱ and width variations, filterable by prefecture or postcode.
- Corporate number lookup
- Returns official name, address, closure status and invoice registration.
- Dated invoice check
- Checks up to 20 T-numbers, optionally as of a given date.
- Bulk name matching
- Attaches corporate numbers to up to 50 names and flags uncertain matches.
- Read-only access
- None of the tools change or send data elsewhere.
Good for
- Add corporate numbers to a spreadsheet of suppliers
- Check whether a vendor's T-number was valid on an invoice date
- Confirm a company's registered address before onboarding
- Find a company's corporate number from a rough name
Pricing
Freemium
Free plan: 500 calls and 50 matches a month; 30-day Pro trial with no card. Paid prices not shown
Prices change. Check bango-api.jp before you buy.
Bango API(法人番号・インボイス) FAQ
What do I need to run it?
Node.js 20 or later and a BANGO_API_KEY, started with npx -y bango-mcp.
Is there a free plan?
Yes. After a 30-day Pro trial the Free plan allows 500 API calls and 50 matches per month.
Does it modify any data?
No, all tools are read-only.
Which licence is it under?
The README says MIT.
Is Bango API(法人番号・インボイス) free?
Bango API(法人番号・インボイス) has a free plan, with paid plans for more usage or features.
How do I add Bango API(法人番号・インボイス) to Claude Code?
Run this command in your terminal: claude mcp add bango-mcp --env BANGO_API_KEY='<BANGO_API_KEY>' -- npx -y bango-mcp
What are the best alternatives to Bango API(法人番号・インボイス)?
The closest alternatives to Bango API(法人番号・インボイス) are Agent-Native Analytics, Google Ads + Meta Ads + SEO/GEO MCP, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP and World Monitor.
Alternatives to Bango API(法人番号・インボイス)

Agent-Native Analytics
MCP serverOpen-source analytics app where an AI agent builds charts and dashboards from your data
- Remote
- Open source
- 7.7K GitHub stars
- Analytics and data

Google Ads + Meta Ads + SEO/GEO MCP
MCP serverHosted MCP connector for managing Google Ads, Meta Ads, GA4 and Search Console from chat
- 8 tools
- Remote
- Freemium
- 8.1K GitHub stars
- Marketing and SEO

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments

World Monitor
MCP serverLive geopolitical intelligence dashboard with an API and MCP server for agents
- Remote
- Freemium
- Analytics and data
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments