TryBiut MCP
This server exposes TryBiut (taxes, invoices, movements, pricing, reports) as 14 MCP tools for AI agents, with public tools that need no login and private tools that use an API token.
Check service health:
trybiut_statusverifies trybiut.com API reachability.Estimate tax savings:
trybiut_tax_previewgives a yearly saving estimate from income, country, and legal form.Calculate tax breakdowns:
trybiut_tax_calculatereturns tax details for an amount, region, business type, and period.Get fiscal calendars:
trybiut_tax_calendarlists tax obligations for a chosen year.See pricing coverage:
trybiut_pricing_countrieslists countries with pricing data.Get help & onboarding:
trybiut_helpexplains registration, login, and token setup;trybiut_auth_registerreturns signup steps and token instructions.Verify identity/profile:
trybiut_mevalidates the token and shows the logged-in user profile.Check subscription:
trybiut_subscriptionreports the current plan.View tax dashboard:
trybiut_dashboard_taxesaggregates tax data for the logged-in user.List invoices:
trybiut_invoices_listreturns user invoices (with a configurable limit).List movements:
trybiut_movements_listreturns bank/income-expense movements.View tax history:
trybiut_tax_historylists filed tax forms.Generate tax reports:
trybiut_reports_taxesprovides a detailed tax report for the logged-in user.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@TryBiut MCP Estimate my annual tax savings for 70k in Spain as autónomo."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
What is this?
This package exposes the TryBiut API as MCP (Model Context Protocol) tools, so assistants like Claude, Cursor, Windsurf, OpenCode or Cline can answer tax questions, check calendars, estimate taxes and — when the user is logged in — work with their own private data (invoices, movements, dashboard, reports).
Related MCP server: Buchhaltungsbutler MCP
Install in one command
No npm publish needed. Point your MCP client at the GitHub repo directly:
{
"mcpServers": {
"trybiut": {
"command": "npx",
"args": ["-y", "github:JMonde/trybiut-mcp"],
"env": {
"TRYBIUT_BASE_URL": "https://trybiut.com",
"TRYBIUT_API_TOKEN": ""
}
}
}
}Claude Code CLI:
claude mcp add trybiut --env TRYBIUT_BASE_URL=https://trybiut.com -- npx -y github:JMonde/trybiut-mcpAfter
npm publish(see "Local development"), replace the args with["-y", "@trybiut/mcp"]. Full example inmcp.example.json.
Claude Desktop: Settings → Developer → Edit MCP config (
claude_desktop_config.json), add thetrybiutblock, restart.Cursor: Settings → MCP → Add server.
Windsurf / Cline: add the block to your
mcp.json.OpenCode: add the block to your
.mcp.json.
Access tiers
Tier | Allows | Requires |
Basic / public |
| Nothing, no login |
Private | Profile, dashboard, invoices, movements, history, reports |
|
Subscription | Full data on paid endpoints | Active plan at pricing |
Security: without a token, private tools answer Login required and make no request with user data. The MCP never asks for or stores passwords — token only. See docs/SECURITY.md.
Getting a token
Create your account: https://trybiut.com/onboarding/chat
Go to https://trybiut.com/dashboard/integrations → API Tokens, create a token (shown once — copy it).
Or via CLI:
npx -y github:JMonde/trybiut-cli login(password is never stored).Paste the token into
TRYBIUT_API_TOKENand restart the MCP client, then verify withtrybiut_me.
The agent can guide you too: the trybiut_auth_register tool returns these steps in chat.
Tools
Tool | Access | Description |
| public | Service health + latency |
| public | Yearly saving estimate |
| public | Breakdown |
| public | Fiscal calendar |
| public | Countries with pricing data |
| public | Help, links, access tiers |
| public | Signup steps + token instructions |
| private | Verify token, show profile |
| private | Subscription status |
| private | Tax dashboard |
| private | Invoices |
| private | Movements |
| private | Filed forms |
| private | Full tax report |
Reference: docs/TOOLS.md · API: docs/API.md · Auth: docs/AUTH.md.
Skill for AI agents
Load SKILL.md, full version at skills/trybiut/SKILL.md:
cp -r skills/trybiut ~/.codex/skills/Local development
cd trybiut-mcp
npm install
npm run build # compile to dist/
npm run smoke # check: 14 tools + requireAuth() gating
npm start # start the MCP server (stdio)Var | Default | Description |
|
| API base |
| — | User token (private tools only) |
|
| Reserved strict mode |
Publishing to npm (optional)
npm login
npm publish --access publicCI publishes automatically on GitHub releases if NPM_TOKEN is set (.github/workflows/publish.yml).
Layout
trybiut-mcp/
├── assets/logo-trybiut.png # official logo
├── docs/ # TOOLS · AUTH · SECURITY · API
├── skills/trybiut/SKILL.md # agent skill
├── src/ # index · tools · client · config
├── scripts/smoke.mjs # smoke test + security invariant
└── mcp.example.json # sample client configPrivacy
Private tools call
requireAuth()before any network: no login, no data leaves the machine.The token only goes to
TRYBIUT_BASE_URLasBearer, redacted in errors (Bearer ***).Revoking the token at https://trybiut.com/dashboard/integrations (or
trybiut logout) cuts access immediately.
Contributing
PRs welcome. Run npm run build && npm run smoke before submitting.
License
MIT © 2026 TryBiut — see LICENSE.
Available Tools
14 toolstrybiut_auth_registerA
Start registration on trybiut.com so you can later use private tools. Returns the signup link + steps.
Inputs: email.
trybiut_dashboard_taxesA
Aggregated tax dashboard of the logged-in user. Requires login (+ subscription for full data).
Inputs: no named parameters.
trybiut_helpA
How to register, log in and get an API token; what works without subscription.
Inputs: no named parameters.
trybiut_invoices_listB
List invoices of the logged-in user. Requires login. Never accessible anonymously.
Inputs: limit.
trybiut_meA
Verify the API token and return the logged-in user profile. Requires login.
Inputs: no named parameters.
trybiut_movements_listB
List bank/income-expense movements of the logged-in user. Requires login.
Inputs: limit.
trybiut_pricing_countriesA
List countries covered by the pricing/market-data module. No login needed.
Inputs: no named parameters.
trybiut_reports_taxesA
Detailed tax report of the logged-in user. Requires login (+ subscription for full data).
Inputs: no named parameters.
trybiut_statusA
Check that trybiut.com API is reachable. No login needed.
Inputs: no named parameters.
trybiut_subscriptionA
Check the current plan/subscription of the logged-in user. Requires login.
Inputs: no named parameters.
trybiut_tax_calculateC
Basic tax breakdown for an amount/region/business type. No login needed.
Inputs: amount (required), period, region, businessType, +1 more.
trybiut_tax_calendarB
Public tax obligations calendar for a year. No login needed.
Inputs: year.
trybiut_tax_historyA
Filed tax forms history of the logged-in user. Requires login.
Inputs: no named parameters.
trybiut_tax_previewA
Basic estimate of yearly tax savings. Public demo endpoint, no login needed.
Inputs: income (required), country, legalForm.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools are cleanly separated by public versus authenticated access and by resource type, but trybiut_dashboard_taxes and trybiut_reports_taxes are close in purpose, and trybiut_tax_preview versus trybiut_tax_calculate could be confused by an agent looking for a generic tax estimate. The descriptions help clarify, but an agent may still misroute requests between these overlapping tax-related tools.
All tools share the trybiut_ prefix and use lowercase snake_case, creating a recognizable family. Most multi-word names follow a domain_resource pattern, though bare nouns like trybiut_status, trybiut_subscription, and trybiut_me are minor deviations from the resource_action feel of names like trybiut_invoices_list and trybiut_auth_register.
Fourteen tools is a reasonable size for a tax/finance connector that covers public demo endpoints plus authenticated account data. It sits near the upper edge of the ideal range, and some reporting tools overlap enough that the set could be slightly tighter.
The toolset covers the core workflow of public exploration, registration, token validation, subscription lookup, and read-only access to taxes, invoices, movements, and reports. It is missing mutation-style operations like creating invoices or filing taxes, but for an API-focused read connector, the main surface is covered.
Maintenance
Related MCP Connectors
Verified, pay-per-use API tools for AI agents through one authenticated connection.
Create invoices, clients, and Stripe payment links from any agent. 7 tools. No email or deletes.
17 pay-per-call web, finance, legal and onchain tools for AI agents. USDC on Base via x402/MPP.
Discover, inspect and run 63,000+ agent tools from one balance. Pay per call, no subscriptions.
Related MCP Servers
- AlicenseNot gradedqualityNot gradedmaintenanceEnables AI assistants to interact with the Finizi B4B platform through 15 comprehensive tools for managing business entities, invoices, vendors, and products. Features secure JWT authentication, automatic retries, and full business-to-business workflow integration through natural language commands.MIT
- AlicenseAqualityAmaintenanceEnables AI assistants to manage BuchhaltungsButler bookkeeping through all 48 API endpoints, with safety-categorized tools for read, write, and destructive operations.4623 npm8MIT
- AlicenseNot gradedqualityBmaintenanceEnables AI agents to issue Chilean electronic tax documents (boleta and factura) stamped at SII via OpenFactura, with stateless bring-your-own-credentials.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to manage Indian enterprise systems by providing tools for accounting (TallyPrime), invoicing (Zoho Books), and GST compliance (validation, e-invoice generation, and GSTR-2B reconciliation), with dry-run-first writes and an audit trail.2Apache 2.0