Build with Tokyo guides

When to use tokyo.how

• Find a practical guide for a Tokyo trip, such as transport, payments, or everyday etiquette.
• Research the steps involved in moving to or living in Tokyo.
• Retrieve a relevant article and cite its URL in an assistant's answer.

These are published guides. Check linked official sources for changing prices, eligibility, and opening times. Use official live services for current disruptions and emergencies.

Connect with MCP

Set your MCP client's server URL to https://tokyo.how/mcp and choose Streamable HTTP. The endpoint is stateless and does not issue a session ID. You do not need to register, create an API key, or obtain an OAuth token.

Initialize the client, then send the initialized notification. The examples use protocol version 2025-11-25; use the version returned by initialization in subsequent MCP-Protocol-Version headers.

curl -sS https://tokyo.how/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  --data '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"tokyo-how-example","version":"1.0.0"}}}'

Discover the current tools and their input schemas:

curl -sS https://tokyo.how/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","method":"notifications/initialized"}'

curl -sS https://tokyo.how/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

Search for guides using a supported language, en or ja:

curl -sS https://tokyo.how/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'MCP-Protocol-Version: 2025-11-25' \
  --data '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_guides","arguments":{"query":"suica card","lang":"en","limit":5}}}'

Use the returned slug with get_guide to retrieve the full article. The website has additional language editions, but MCP tool inputs currently accept English and Japanese.

The separate request_article tool and POST /api/article-request create an editorial submission and can notify the operator. Use them only when the user asks to submit a request or report. A successful response acknowledges receipt and does not guarantee publication, a reply, or notification delivery.

Request Markdown

Use Accept: text/markdown on an HTML page. A successful conversion returns Content-Type: text/markdown and Vary: Accept. Browser requests continue to receive HTML. Missing pages keep their HTTP 404 status when returned as Markdown.

curl -sS -L -i \
  -H 'Accept: text/markdown' \
  https://tokyo.how/

curl -sS -L -i \
  -H 'Accept: text/html' \
  https://tokyo.how/

Start with the content index when you need to find a suitable article before requesting its body.

Use the CLI

The tokyo.how CLI is a downloadable script for Node.js 22 or later. Save it locally and review the file before running it. It provides read-only access to the public guides.

curl -fSLo tokyo-how.mjs https://tokyo.how/cli/tokyo-how.mjs
# Review the downloaded file in your editor before running it.
node tokyo-how.mjs --help
node tokyo-how.mjs search "suica card" --lang en --limit 5 --json
node tokyo-how.mjs get suica-card --lang ja
node tokyo-how.mjs categories --lang en
node tokyo-how.mjs list --lang en
node tokyo-how.mjs latest --lang ja --limit 5

Commands are search, get, categories, list, and latest. Use --lang en or --lang ja, --limit where supported, and --json for machine-readable output. Run --help for command details. No package-manager installation is required.

Use tools in a supported browser

On browsers that support WebMCP, tokyo.how registers search_tokyo_guides and get_tokyo_guide when the page loads. Both read public guide content in English or Japanese. They do not submit article requests or access saved conversations.

WebMCP is an evolving browser API and is not available in every browser. The regular website, MCP endpoint, and CLI remain usable without it.

Discovery documents

API catalog

RFC 9727 links to the APIs, their descriptions, and liveness status.

OpenAPI

HTTP operations, request bodies, and response schemas.

AI catalog

MCP metadata, the OpenAPI document, and agent instructions.

MCP metadata

Endpoint, tool names, supported languages, and access information.

Agent skill

When to use the service, how to search, and how to cite a guide.

Content index

An entry point to published guide content.

Access model

Public access and editorial submission behavior.

Liveness

Application response status; does not test every tool or external dependency.

Application liveness confirms that the application can respond. It does not exercise every MCP tool, search asset, or external email service.

Citations and support

Link to the article you used and credit tokyo.how. Access to a public API does not grant additional content-reuse rights; follow the terms of service and privacy policy.

For integration questions or errors, use the contact page. The MCP client guide has additional connection instructions.