Ask Japan
Japanese company, invoice and postcode data, plus human services in Japan. Human services are paid.
Live Answered an MCP handshake without credentials and listed 16 tools.
- Category
- Finance & markets
- Transport
http- Source
- https://github.com/ihouse-corp/ask-japan-mcp
- Endpoint
https://askjapan.senpinai.com/mcp- MCP Registry
com.senpinai/ask-japan- Reports itself as
- ask-japan 1.1.0
- Protocol
- 2025-06-18
- Tools
- 16
- Context cost
- about 2,550 tokens for the tool definitions (estimated at four characters per token)
- Tool definitions last changed
- no change seen since first check
- Handshake time
- 568 ms
- Repository
- 0 stars · last push 2026-11-13
- Last checked
- 2026-11-22 11:27:26 UTC
- Listed since
- 2026-11-18
Health and compatibility
| Endpoint reachable | Verified | Responded in 568 ms |
|---|---|---|
| MCP handshake (initialize) | Verified | Completed without credentials |
| Tool discovery (tools/list) | Verified | 16 tools listed |
| Authentication | Verified | None needed to connect |
| Protocol version | Verified | 2025-06-18 |
| Transport | Verified | Streamable HTTP |
| Capabilities declared | Verified | resources, tools |
Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.
Recent history
5 daily checks so far; median response 568 ms. Green answered, violet asked for auth, red did not answer.
Set up in your client
Claude Code
Run this in a terminal:
claude mcp add --transport http ask-japan https://askjapan.senpinai.com/mcpClaude Desktop
Open Settings → Connectors → Add custom connector and paste this URL:
https://askjapan.senpinai.com/mcpOr bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):
{
"mcpServers": {
"ask-japan": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://askjapan.senpinai.com/mcp"
]
}
}
}Cursor
Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):
{
"mcpServers": {
"ask-japan": {
"url": "https://askjapan.senpinai.com/mcp"
}
}
}VS Code
Or add it to .vscode/mcp.json:
{
"servers": {
"ask-japan": {
"type": "http",
"url": "https://askjapan.senpinai.com/mcp"
}
}
}Or from a terminal:
code --add-mcp '{"name": "ask-japan", "type": "http", "url": "https://askjapan.senpinai.com/mcp"}'Windsurf
Add it to ~/.codeium/windsurf/mcp_config.json:
{
"mcpServers": {
"ask-japan": {
"serverUrl": "https://askjapan.senpinai.com/mcp"
}
}
}Other clients
Most clients accept this shape. The endpoint is:
https://askjapan.senpinai.com/mcp{
"mcpServers": {
"ask-japan": {
"type": "http",
"url": "https://askjapan.senpinai.com/mcp"
}
}
}If it does not connect
- Restart the client after editing a config file, and keep keys out of files you commit.
- If the tools do not appear, open the client's MCP log: a 401 means the credentials were not accepted, and a timeout means the server did not answer.
Tools 16
Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON
check_availabilityread-onlyCheck whether a new request can be taken now. Remote work (calls, online reservations) has a daily limit; …
Check whether a new request can be taken now. Remote work (calls, online reservations) has a daily limit; on-the-ground work takes one job at a time. Returns open or full and when it reopens.
Takes no parameters.
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "check_availability",
"arguments": {}
}
}check_invoiceread-onlyCheck whether a Japanese corporation is a registered Qualified Invoice Issuer (needed for consumption-tax …
Check whether a Japanese corporation is a registered Qualified Invoice Issuer (needed for consumption-tax credit). Accepts T + 13 digits or the 13-digit corporate number.
| Parameter | Type | Description | |
|---|---|---|---|
number | string | required | Invoice registration number (T1234567890123) or corporate number |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "check_invoice",
"arguments": {
"number": "..."
}
}
}check_openread-onlyCheck whether a MARU Order restaurant is taking takeout orders now, its hours and whether it accepts JPYC …
Check whether a MARU Order restaurant is taking takeout orders now, its hours and whether it accepts JPYC with a discount.
| Parameter | Type | Description | |
|---|---|---|---|
shop | string | required |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "check_open",
"arguments": {
"shop": "..."
}
}
}get_company_profileread-onlyOne profile for a Japanese corporation from its 13-digit corporate number: registered name and address, …
One profile for a Japanese corporation from its 13-digit corporate number: registered name and address, invoice (tax) registration status, and listing, industry and capital if it files with EDINET.
| Parameter | Type | Description | |
|---|---|---|---|
corporate_number | string | required | 13-digit corporate number |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_company_profile",
"arguments": {
"corporate_number": "..."
}
}
}get_menuread-onlyGet a MARU Order restaurant's menu: categories, items with tax-included JPY prices, options (size, toppings), …
Get a MARU Order restaurant's menu: categories, items with tax-included JPY prices, options (size, toppings), allergens and sold-out flags. Use list shop slugs from the maru://order/shops resource.
| Parameter | Type | Description | |
|---|---|---|---|
shop | string | required | Shop slug, e.g. maru-demo |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_menu",
"arguments": {
"shop": "..."
}
}
}get_request_statusread-onlyGet the status of a request: received, quoted (price and how to pay), paid, in_progress, done (with result), …
Get the status of a request: received, quoted (price and how to pay), paid, in_progress, done (with result), cancelled or refunded.
| Parameter | Type | Description | |
|---|---|---|---|
request_id | string | required | The request_id returned by request_service |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "get_request_status",
"arguments": {
"request_id": "..."
}
}
}list_servicesread-onlyList the services MARU Japan Hands provides in Japan (Japanese phone calls, restaurant and golf reservations, …
List the services MARU Japan Hands provides in Japan (Japanese phone calls, restaurant and golf reservations, shopping proxy, on-site checks, interpreting, Osaka stays, home search and property viewings, app development), with prices in JPY, limits and what is not offered.
Takes no parameters.
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "list_services",
"arguments": {}
}
}lookup_postcoderead-onlyGet the address for a 7-digit Japanese postcode, including large offices that have their own postcode.
Get the address for a 7-digit Japanese postcode, including large offices that have their own postcode.
| Parameter | Type | Description | |
|---|---|---|---|
postcode | string | required | 7 digits, hyphen optional, e.g. 530-0001 |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "lookup_postcode",
"arguments": {
"postcode": "..."
}
}
}place_takeout_ordercan modifyexternal accessPlace a takeout order. Returns an order number and a link. The customer pays at pickup at the counter, or …
Place a takeout order. Returns an order number and a link. The customer pays at pickup at the counter, or opens the link to pay with JPYC (discounted). This tool never charges or moves money.
| Parameter | Type | Description | |
|---|---|---|---|
shop | string | required | |
items | object[] | required | |
pickup_time | string | required | Pickup time today in JST, HH:MM |
name | string | required | Name for the order |
contact | string | optional | Phone or email for the shop to reach the customer |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "place_takeout_order",
"arguments": {
"shop": "...",
"items": [],
"pickup_time": "...",
"name": "..."
}
}
}quote_purchaseread-onlyInstant cost estimate to buy an item sold in Japan and ship it: item price (from the shop page the user or …
Instant cost estimate to buy an item sold in Japan and ship it: item price (from the shop page the user or agent found), our fee (10%, minimum JPY 2,000) and shipping estimated from Japan Post's official EMS table. Read-only: it does not order or charge anything.
| Parameter | Type | Description | |
|---|---|---|---|
item_name | string | optional | Product name |
item_url | string | optional | Product page URL in Japan (Rakuten, Amazon.co.jp, brand store, etc.) |
item_price_jpy | integer | required | Price per unit in JPY, tax included, as shown on the shop page |
quantity | integer | optional | |
seller_shipping_jpy | integer | optional | Shop's shipping to our address in Japan, if any |
ship_to_country | string | required | ISO 2-letter country code of the destination, e.g. US, TW, CN; JP for Japan |
estimated_weight_kg | number | optional | Item weight in kg if known (default 1.0) |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "quote_purchase",
"arguments": {
"item_price_jpy": 0,
"ship_to_country": "..."
}
}
}request_servicecan modifyexternal accessSend a request for a service in Japan. Fixed-price services (phone_call JPY 1,500, restaurant_booking JPY …
Send a request for a service in Japan. Fixed-price services (phone_call JPY 1,500, restaurant_booking JPY 3,000, interpreting JPY 5,000 per 30 min) return the quote and payment details immediately. Other services get a fixed quote from a person within 2 hours (JST 09:00-21:00); requests sent outside hours are handled from 09:00. No email is needed: follow up with get_request_status. Creating a request is free and does not move any money. Full refund if we cannot do the task or you cancel before work starts.
| Parameter | Type | Description | |
|---|---|---|---|
service | string | required | Service id from list_services One of: ai_agent_integration, custom, interpreting, phone_call, photo_check, property_search, property_viewing, queue_pickup … |
details | string | required | What, where, when, how many people, names, constraints |
contact_email | string | optional | Optional email for the quote and result |
callback_url | string | optional | Optional public https URL that receives status updates as JSON |
language | string | optional | Preferred language for replies, e.g. en, ja, zh |
budget_jpy | integer | optional | Optional budget in JPY |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "request_service",
"arguments": {
"service": "ai_agent_integration",
"details": "..."
}
}
}search_addressread-onlyFind postcodes by part of a Japanese address or an office name, e.g. 大阪市北区梅田.
Find postcodes by part of a Japanese address or an office name, e.g. 大阪市北区梅田.
| Parameter | Type | Description | |
|---|---|---|---|
text | string | required | Part of the address in Japanese |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_address",
"arguments": {
"text": "..."
}
}
}search_companyread-onlySearch all ~5.8 million corporations registered in Japan by name (Japanese, partial match). Returns corporate …
Search all ~5.8 million corporations registered in Japan by name (Japanese, partial match). Returns corporate number, address, type and whether it is closed. Use the corporate number with get_company_profile.
| Parameter | Type | Description | |
|---|---|---|---|
name | string | required | Company name or part of it, in Japanese, e.g. トヨタ自動車 |
prefecture | string | optional | Optional prefecture filter in Japanese, e.g. 大阪府 |
include_closed | boolean | optional | Include closed corporations (default false) |
limit | integer | optional |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_company",
"arguments": {
"name": "..."
}
}
}search_listed_companiesread-onlyFilter companies that file securities reports in Japan (EDINET) by industry (Japanese name, e.g. 不動産業, 輸送用機器) …
Filter companies that file securities reports in Japan (EDINET) by industry (Japanese name, e.g. 不動産業, 輸送用機器) and minimum capital. Returns securities code and capital.
| Parameter | Type | Description | |
|---|---|---|---|
industry | string | optional | EDINET industry name in Japanese |
min_capital_million_yen | number | optional | |
listed_only | boolean | optional | Only listed companies (default true) |
limit | integer | optional |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_listed_companies",
"arguments": {}
}
}search_osaka_staysread-only查大阪民宿及房型,无需凭证。参考起价不是最终报价。Search Osaka stays and room types; prices indicative.
查大阪民宿及房型,无需凭证。参考起价不是最终报价。Search Osaka stays and room types; prices indicative.
| Parameter | Type | Description | |
|---|---|---|---|
query | string | optional | |
guests | integer | optional | |
locale | string | optional | One of: zh-CN, zh-TW, en, ja, ko |
limit | integer | optional |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "search_osaka_stays",
"arguments": {}
}
}submit_osaka_booking_requestcan modifyexternal access这是申请不是订成,不锁房、不收费。Home-booking 人工报价及代订。请把返回的专属链接私下交给客人保存,客人本人在该页确认报价后去 Home-booking …
这是申请不是订成,不锁房、不收费。Home-booking 人工报价及代订。请把返回的专属链接私下交给客人保存,客人本人在该页确认报价后去 Home-booking 刷卡;邮件送达未核实,不可承诺一定收到邮件。绝不在工具里收款或收集卡号、护照。 Only after explicit guest consent to saving contact details and contacting the property. Reuse idempotencyKey on retries. No quote acceptance or checkout in this tool.
| Parameter | Type | Description | |
|---|---|---|---|
propertyId | string | required | |
roomId | string | required | |
checkIn | string | required | |
checkOut | string | required | |
guestName | string | required | |
email | string | required | |
idempotencyKey | string | required | |
guests | integer | required | |
consentToContact | boolean | required | |
locale | string | optional | One of: zh-CN, zh-TW, en, ja, ko |
Example call (required arguments only, placeholder values):
{
"method": "tools/call",
"params": {
"name": "submit_osaka_booking_request",
"arguments": {
"propertyId": "...",
"roomId": "...",
"checkIn": "...",
"checkOut": "...",
"guests": 0,
"guestName": "...",
"email": "...",
"idempotencyKey": "...",
"consentToContact": false
}
}
}Resources 1
MARU Order shopsRestaurants that take orders through MARU Order
Badge
Maintain this server? Put its live status in your README:
[](https://mcp.aianytime.net/s/ask-japan/)Edit this entry · Report a problem
More in Finance & markets
Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt
Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers