# Bango API（法人番号・インボイス）

> Bango API（法人番号・インボイス） is a freemium MCP server for analytics and data. Look up Japanese companies by name, corporate number or invoice T-number. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://bango-api.jp
- **Repository:** https://github.com/taku1211/bango-mcp
- **MCP Registry name:** io.github.taku1211/bango-mcp
- **Categories:** analytics and data, finance and payments
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add bango-mcp --env BANGO_API_KEY='<BANGO_API_KEY>' -- npx -y bango-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "bango-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bango-mcp"
      ],
      "env": {
        "BANGO_API_KEY": "<BANGO_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "bango-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bango-mcp"
      ],
      "env": {
        "BANGO_API_KEY": "<BANGO_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "bango-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "bango-mcp"
      ],
      "env": {
        "BANGO_API_KEY": "<BANGO_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "bango-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bango-mcp"
      ],
      "env": {
        "BANGO_API_KEY": "<BANGO_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "bango-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "bango-mcp"
      ],
      "env": {
        "BANGO_API_KEY": "<BANGO_API_KEY>"
      }
    }
  }
}
```

## Tools

- `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

## 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

- [Agent-Native Analytics](https://ai-powered.com/mcp/agent-native-analytics): Agent-Native Analytics is an open-source MCP server for analytics and data.
- [Google Ads + Meta Ads + SEO/GEO MCP](https://ai-powered.com/mcp/google-ads-meta-ads-seo-geo-mcp): Google Ads + Meta Ads + SEO/GEO MCP is a freemium MCP server for marketing and seo.
- [Solana MCP by Vybe](https://ai-powered.com/mcp/solana-mcp-by-vybe): Solana MCP by Vybe is an MCP server for finance and payments.
- [Tapetide - Indian Stock Market MCP](https://ai-powered.com/mcp/tapetide-indian-stock-market-mcp): Tapetide - Indian Stock Market MCP is a freemium MCP server for finance and payments.
- [World Monitor](https://ai-powered.com/mcp/world-monitor): World Monitor is a freemium MCP server for analytics and data.
- [Budget Tracker](https://ai-powered.com/mcp/budget-tracker-2): Budget Tracker is a freemium MCP server for finance and payments.
- [CompanyData](https://ai-powered.com/mcp/companydata): CompanyData is a paid MCP server for analytics and data.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/bango-api
