Tedolly MCP Server

Tedolly calculates real monthly take-home pay for sole proprietors in Japan. Enter your revenue and expenses, and it subtracts income tax, resident tax, enterprise tax, consumption tax, national pension, and national health insurance to show what you actually keep this month, and how much to set aside.

Japan only. Tedolly implements the Japanese tax and social insurance system. It is not useful for other countries.

The MCP server lets an AI assistant do this in conversation:

“I billed 800,000 yen this month with 150,000 in expenses. What’s my take-home?”

“Show me how my take-home changed from April to September.”

“Add a 12,000 yen travel expense to last month’s record.”

https://tedolly.com/

Connection


Transport	Streamable HTTP (POST)
Server URL	`https://tedolly-backend-d5a3trnmra-an.a.run.app/api/v1/mcp`
Authentication	OAuth 2.1 with PKCE (S256). Client ID Metadata Documents supported
Protected Resource Metadata	`https://tedolly-backend-d5a3trnmra-an.a.run.app/.well-known/oauth-protected-resource/api/v1/mcp` (RFC 9728, path-suffix form)
Authorization Server Metadata	`https://tedolly-backend-d5a3trnmra-an.a.run.app/.well-known/oauth-authorization-server`
Scopes	`mcp:read` `mcp:calculate` `mcp:write` `mcp:items`
Account required	Yes, free
Price	Free for now

The server is hosted on Google Cloud Run, which is why the host is not tedolly.com. It is operated by Tedolly. A custom domain is planned; this page will be updated when it moves.

Setup

Create a free Tedolly account and fill in your basic settings (business type, blue/white return).

https://tedolly.com/
Add the server URL as a custom connector in your MCP client.
- Claude.ai: Settings → Customize → Connectors → Add → add custom connector. Adding it does not start the connection; enable the connector in a chat and the consent window opens on first use.
- Claude Code: claude mcp add with the URL, then run /mcp to open the consent screen in your browser.
Sign in to Tedolly when the OAuth consent screen opens.
Ask your assistant about your take-home pay.

Tools

Ten tools. Five read, five write.

Tool	Type	What it does
`calculate_take_home`	read	Calculates take-home pay from revenue and expenses. Does not persist anything
`get_basic_settings`	read	Returns the user’s business type and filing settings
`get_take_home_record`	read	Returns one saved monthly record
`list_take_home_records`	read	Lists saved months
`get_yearly_summary`	read	Returns yearly totals for revenue, expenses, and take-home
`save_take_home_record`	write	Saves a calculation as that month’s record
`add_sales_item`	write	Adds one revenue line to a saved month
`add_expense_item`	write	Adds one expense line to a saved month
`remove_sales_item`	write	Removes one revenue line
`remove_expense_item`	write	Removes one expense line

All tools carry MCP tool annotations. The five read tools are readOnlyHint: true and idempotent. add_sales_item / add_expense_item only append and are not marked destructive. remove_* and save_take_home_record are destructiveHint: true (save can overwrite an existing month; remove_* require a server-issued confirmation token). calculate_take_home persists nothing.

Verified clients

Claude (claude.ai, browser)
Claude Code (terminal)

Both verified at production rollout in September 2026. Other clients (Cursor, ChatGPT) have not been tested and are not claimed. This list grows as clients are verified.

Scope and limits

Tedolly is for full-time sole proprietors in Japan. It does not cover:

People with salary income (side-business freelancers). Combined salary and business income is not supported
Incorporated businesses. No corporate tax calculation
Tax filing. Tedolly estimates; it does not file returns or replace accounting software

National health insurance rates vary by municipality. Tedolly uses one standard region’s rates, so the figure is an estimate, not your municipality’s exact amount.

Data handling

A calculation alone is not stored. Monthly records and line items you save are stored in your Tedolly account
MCP operations read and write the same data as the web interface
OAuth 2.1 means your password is never shared with the AI client. You can revoke access at any time

https://tedolly.com/privacy

Try it

No account needed for a single calculation. No card required.

https://tedolly.com/

This page is general information, not individual tax advice. Actual taxes and insurance premiums depend on your municipality and circumstances. Consult a licensed tax professional for filing decisions.

Author: Tedolly’s developer (not a licensed tax accountant)

Last updated: 2026-11-14