Skip to content
MCP server

Bango API(法人番号・インボイス)

Look up Japanese companies by name, corporate number or invoice T-number

Runs locallyStatus and history
Install
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-mcp

Add 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(法人番号・インボイス)

  1. Open-source analytics app where an AI agent builds charts and dashboards from your data

    • Remote
    • Open source
    • 7.7K GitHub stars
    • Analytics and data
  2. Hosted 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
  3. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  4. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  5. World Monitor

    MCP server

    Live geopolitical intelligence dashboard with an API and MCP server for agents

    • Remote
    • Freemium
    • Analytics and data
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments