Bismo — AI connection / MCP

Call Bismo's public data from your AI, with sources

Connect an AI agent like Claude to call subsidies, company info and laws — always with sources

Works with — Claude · Claude Code · ChatGPT · Codex · Cursor and other MCP clients

01What is MCP

What are MCP and the Claude plugin

Your AIClaude · Cursor · Codex
MCPA shared socket (like an outlet standard)
Bismo public dataWith sources & timestamps

Claude or Cursor use the same socket (MCP). The Claude plugin is a one-click shortcut to plug it in, for Claude.

MCP

The socket "standard"

A shared way (common rules) to connect an AI to outside data — like an outlet standard, so Claude and Cursor use the same socket.

Claude plugin

A one-click "shortcut"

A handy Claude-only bundle that plugs into that socket in one click. The features live in the socket (MCP); the plugin is just a shortcut for Claude.

02How to connect

How to connect

Pick your client — we show only its steps

No API key needed. You authorize once in the browser with a Bismo account (OAuth)

Every code block says where to type or paste it. The same line will not work in the wrong place

claude.ai (browser) and the Claude desktop app follow the same steps — no terminal needed

  1. Open Settings → Connectors

  2. Paste this URL into “Add custom connector”

    Claude settingsConnectors → Add custom connector → URL field
    https://mcp.bismo.ai/functions/v1/mcp-server

    We suggest naming the connection "Bismo" — easier to find later

  3. Finish sign-in in the browser

    A browser window opens; approve with your Bismo account. There is no API key to enter

  4. In a new chat, click + → Connectors → enable “Bismo”

    Claude chat inputPaste into a new chat and send
    Using Bismo, find subsidies for manufacturing sorted by nearest deadline, with sources
03What to ask

What to ask once connected

Just ask in plain language. You get reference material, with sources.

›Give the corporate number and address for a client company, with sources

gBizINFO (METI)Official

›Find subsidies for manufacturing

J-Grants (Digital Agency)Official

›Look up personal-data-protection laws

e-Gov Laws Search (Digital Agency)Official

›Give HS code candidates for this product, as reference material

Customs Tariff Schedule (Japan Customs)AI estimate

›Did the tariff rate for chocolate change in 2026? If so, show both editions with sources

Customs Tariff Schedule (Japan Customs)Bismo-normalized
04Our promise

Our promise

Bismo returns reference material, not determinations. Each tool shows its authority tier. Final confirmation belongs to a certified professional or a licensed customs broker.

Official→Bismo-normalized→AI summary→AI estimate

4 authority tiers — Official, Bismo-normalized, AI summary, AI estimate. Each value carries one.

05For developers

For developers — tool list

Once connected, your AI can call these tools. List tools narrow down candidates; take confirmed values from the detail tools

28tools in 5 groups

This list and its count come from the MCP server registry. One further tool is gated and does not appear in the public list

4 authority tiersOfficialBismo-normalizedAI summaryAI estimate

Companies4

  • search_companyOfficial

    Find a Japanese company by name or corporate number. A list for narrowing candidates; take confirmed values from get_entity_profilegBizINFO (METI)

  • get_entity_profileOfficial

    Get financials, headcount and certifications by corporate numbergBizINFO (METI)

  • search_nta_corporate_nameOfficial

    Search corporate-number records by company name (covers small and newly registered companies). A list for narrowing candidates; take confirmed values from get_nta_corporate_recordNational Tax Agency corporate numbers

  • get_nta_corporate_recordOfficial

    Get one record with its change history (name change, relocation, merger, dissolution)National Tax Agency corporate numbers

Subsidies2

  • search_subsidiesOfficial

    Find subsidies by keyword, industry or region. A list for narrowing candidates; take confirmed values from get_subsidy_detailJ-Grants (Digital Agency)

  • get_subsidy_detailOfficial

    Get one subsidy's criteria, cap, deadline and formsJ-Grants (Digital Agency)

Disclosure3

  • search_edinet_documentsOfficial

    Search filings by date, corporate number or document type. A list for narrowing candidates; take confirmed values from get_edinet_documentEDINET (FSA)

  • get_edinet_documentOfficial

    Download one filing as PDF, XBRL or CSVEDINET (FSA)

  • get_edinet_company_disclosuresOfficial

    Get one company's recent filings, clustered by typeEDINET (FSA)

Laws & sources3

  • search_egov_lawsOfficial

    Search acts, cabinet orders and ministerial ordinances. A list for narrowing candidates; take confirmed values from get_egov_laws_datae-Gov Laws Search (Digital Agency)

  • get_egov_laws_dataOfficial

    Fetch the full statute body by law IDe-Gov Laws Search (Digital Agency)

  • get_evidence_refsBismo-normalized

    Currently always returns empty (per-value citations are not populated yet). Use each tool's own source insteadCross-source — citations per value

Trade & customs16

  • customs_hs_lookupAI estimate

    Suggest HS code candidates from a product descriptionCustoms Tariff Schedule (Japan Customs)

  • customs_tariff_rate_lookupOfficial

    Look up general, WTO, preferential and EPA rates (22 partner countries)Customs Tariff Schedule (Japan Customs)

  • customs_edition_changesBismo-normalized

    Show which official field changed between two editions, citing bothCustoms Tariff Schedule (Japan Customs)

  • customs_candidate_impactAI estimate

    Get tariff rates and import-related law signals for every candidate in one callCross-source (Customs and others)

  • customs_classification_commentaryOfficial

    Check general rules, section, chapter and subheading notesCustoms tariff schedule notes

  • customs_classification_explanatory_notesBismo-normalized

    Check WCO explanatory notes and domestic classification rulingsCustoms explanatory notes & rulings

  • customs_advance_ruling_lookupOfficial

    Search past advance rulings by product or HS codeCustoms advance rulings

  • customs_other_law_signalsBismo-normalized

    Surface confirmation signals for import-related lawsOther import-related laws

  • customs_classification_advisoryPaidAI summary

    AI-organized classification reference material, with citationsCross-source (Customs and others)

  • customs_food_other_laws_advisoryPaidAI summary

    AI-organized reference material for food-related import lawsCross-source (Food Sanitation Act and others)

  • trade_batch_intakeBismo-normalized

    Accept a pasted table as a case and return the intake breakdownThe user's own case

  • trade_batch_reviewBismo-normalized

    Confirm the intake breakdown (nothing is resolved before confirmation)The user's own case

  • trade_batch_supplementBismo-normalized

    Fill in missing facts and create a new version of the caseThe user's own case

  • trade_batch_resolvePaidAI estimate

    Resolve one row at a time and return each row's state and reasonCustoms and other cited sources

  • trade_batch_exportPaidAI estimate

    Receive a CSV that maps back to the original rows, with sources, timestamps and a content hashCustoms and other cited sources

  • trade_result_eventYour own report

    Record whether you adopted, revised, rejected or escalated a result (append-only)The user's own report

AI summary and AI estimate are reference material, not determinations

Final HS classification, tariff application and customs procedures must be verified with a licensed customs broker or Japan Customs

Signatures and sample JSON are published in the Plugin OSS (Apache 2.0) repository