Skip to main content
Glama
TryBiut MCP

TryBiut MCP

by JMonde

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-mcp

After npm publish (see "Local development"), replace the args with ["-y", "@trybiut/mcp"]. Full example in mcp.example.json.

  • Claude Desktop: Settings → Developer → Edit MCP config (claude_desktop_config.json), add the trybiut block, 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

status, saving preview, tax calculation, calendar, pricing countries, help

Nothing, no login

Private

Profile, dashboard, invoices, movements, history, reports

TRYBIUT_API_TOKEN (logged in)

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

  1. Create your account: https://trybiut.com/onboarding/chat

  2. Go to https://trybiut.com/dashboard/integrations → API Tokens, create a token (shown once — copy it).

  3. Or via CLI: npx -y github:JMonde/trybiut-cli login (password is never stored).

  4. Paste the token into TRYBIUT_API_TOKEN and restart the MCP client, then verify with trybiut_me.

The agent can guide you too: the trybiut_auth_register tool returns these steps in chat.

Tools

Tool

Access

Description

trybiut_status

public

Service health + latency

trybiut_tax_preview

public

Yearly saving estimate {income, country, legalForm}

trybiut_tax_calculate

public

Breakdown {amount, region, businessType, period}

trybiut_tax_calendar

public

Fiscal calendar {year}

trybiut_pricing_countries

public

Countries with pricing data

trybiut_help

public

Help, links, access tiers

trybiut_auth_register

public

Signup steps + token instructions

trybiut_me

private

Verify token, show profile

trybiut_subscription

private

Subscription status

trybiut_dashboard_taxes

private

Tax dashboard

trybiut_invoices_list

private

Invoices {limit}

trybiut_movements_list

private

Movements {limit}

trybiut_tax_history

private

Filed forms

trybiut_reports_taxes

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

TRYBIUT_BASE_URL

https://trybiut.com

API base

TRYBIUT_API_TOKEN

—

User token (private tools only)

TRYBIUT_REQUIRE_SUBSCRIPTION

false

Reserved strict mode

Publishing to npm (optional)

npm login
npm publish --access public

CI 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 config

Privacy

  • Private tools call requireAuth() before any network: no login, no data leaves the machine.

  • The token only goes to TRYBIUT_BASE_URL as Bearer, 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 tools
trybiut_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

    B3.4/5.0

    Scored across 14 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count4/5

    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.

    Completeness4/5

    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

    ActivityStale
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      Not graded
      maintenance
      Enables 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
    • A
      license
      A
      quality
      A
      maintenance
      Enables AI assistants to manage BuchhaltungsButler bookkeeping through all 48 API endpoints, with safety-categorized tools for read, write, and destructive operations.
      46
      23 npm
      8
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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.
      2
      Apache 2.0