Skip to main content
Glama
JMonde

TryBiut MCP

by JMonde

✨ ¿Qué es esto? / What is this?

🇪🇸 Español: Este paquete expone la API de TryBiut como herramientas MCP (Model Context Protocol) para que asistentes como Claude, Cursor, Windsurf, OpenCode o Cline puedan responder preguntas fiscales, consultar calendarios, estimar impuestos y —si el usuario inicia sesión— trabajar con sus propios datos (facturas, movimientos, dashboard, informes).

🇬🇧 English: This package exposes the TryBiut API as MCP tools so AI assistants can answer tax questions, check calendars, estimate taxes and —when logged in— work with the user's own private data.

Related MCP server: company-gibraltar-mcp

🔓 Modelo de acceso / Access tiers

Nivel

¿Qué permite?

¿Necesita…?

🟢 Básico / público

status, previsión de ahorro 🧮, cálculo 🧾, calendario 📅, países de pricing 🌍, ayuda ❓

Nada. Sin login

🔒 Privado

Tu perfil 👤, dashboard 📊, facturas 🧾, movimientos 💸, historial 🗂️, informes 📈

TRYBIUT_API_TOKEN (estar logueado)

💳 Suscripción

Datos completos en endpoints de pago

Plan activo en pricing

🛡️ Seguridad: sin token, las herramientas privadas responden 🔒 Login required y no hacen ninguna petición con datos de usuario. El MCP jamás pide ni guarda contraseñas — solo el token. Detalles en docs/SECURITY.md.

🚀 Instalación (2 min)

1️⃣ Requisito

  • Node.js ≥ 18

2️⃣ Configura tu cliente MCP

Copia este bloque (Claude Desktop, Cursor, Windsurf, OpenCode, Cline… todos usan el mismo formato):

{
  "mcpServers": {
    "trybiut": {
      "command": "npx",
      "args": ["-y", "@trybiut/mcp"],
      "env": {
        "TRYBIUT_BASE_URL": "https://trybiut.com",
        "TRYBIUT_API_TOKEN": "PEGA_AQUI_TU_TOKEN (opcional)"
      }
    }
  }
}

📄 Ejemplo listo en mcp.example.json.

  1. Abre Configuración → Desarrollador → Editar configuración MCP (claude_desktop_config.json).

  2. Añade el bloque trybiut dentro de mcpServers.

  3. Reinicia Claude Desktop. Verás 🟡 TryBiut en la lista de herramientas.

  • Cursor: Settings → MCP → Add server y pega el bloque.

  • Windsurf / Cline: añade el bloque a tu mcp.json del proyecto o global.

  • OpenCode: añade el bloque a tu .mcp.json.

3️⃣ Sin token funciona (modo básico) ✅

Sin TRYBIUT_API_TOKEN ya puedes: estado del servicio, estimaciones, cálculos, calendario y ayuda.

4️⃣ Con token (tus datos) 🔑

  1. 📝 Crea tu cuenta: https://trybiut.com/register

  2. 🔑 Entra: https://trybiut.com/login

  3. 🎟️ Copia tu token: https://trybiut.com/dashboard/api-tokens

  4. 📋 Pégalo en TRYBIUT_API_TOKEN y reinicia el cliente MCP.

  5. ✅ Pide al agente: “verifica mi login con trybiut_me.

💡 El agente también sabe guiarte: la herramienta trybiut_auth_register devuelve estos pasos dentro del chat.

🧰 Herramientas / Tools

#

Tool

🔓

Descripción

1

trybiut_status

🟢

🟢 Estado del servicio + latencia

2

trybiut_tax_preview

🟢

🧮 Estimación de ahorro anual {income, country, legalForm}

3

trybiut_tax_calculate

🟢

🧾 Desglose {amount, region, businessType, period}

4

trybiut_tax_calendar

🟢

📅 Calendario fiscal {year}

5

trybiut_pricing_countries

🟢

🌍 Países con datos de pricing

6

trybiut_help

🟢

❓ Ayuda, enlaces y niveles de acceso

7

trybiut_auth_register

🟢

📝 Pasos para registrarse y obtener token

8

trybiut_me

🔒

👤 Verifica el token y muestra tu perfil

9

trybiut_subscription

🔒

💳 Estado de tu suscripción

10

trybiut_dashboard_taxes

🔒

📊 Tu dashboard fiscal

11

trybiut_invoices_list

🔒

🧾 Tus facturas {limit}

12

trybiut_movements_list

🔒

💸 Tus movimientos {limit}

13

trybiut_tax_history

🔒

🗂️ Tus modelos presentados

14

trybiut_reports_taxes

🔒

📈 Tu informe fiscal completo

📖 Referencia completa: docs/TOOLS.md · API: docs/API.md · Auth: docs/AUTH.md.

🤖 Skill para agentes de IA

¿Eres un agente? Carga la skill:

📄 SKILL.md → completa en skills/trybiut/SKILL.md

# copiar a tu carpeta de skills, p. ej.:
cp -r skills/trybiut ~/.codex/skills/

La skill enseña al agente: qué herramienta usar en cada caso, los 3 niveles de acceso, recetas (🧮 calcular, 📅 calendario, 📊 dashboard…) y las reglas de seguridad (🔑 nunca pedir contraseñas, 🙈 nunca imprimir el token).

💻 Desarrollo local

cd trybiut-mcp
npm install
npm run build      # compila a dist/
npm run smoke      # ✅ chequeo: 14 tools + gating requireAuth()
npm start          # arranca el servidor MCP (stdio)

Variables (cp .env.example .env):

Var

Default

Descripción

TRYBIUT_BASE_URL

https://trybiut.com

Base de la API

TRYBIUT_API_TOKEN

Token del usuario (solo privado)

TRYBIUT_REQUIRE_SUBSCRIPTION

false

Reservado: modo estricto

🗂️ Estructura

trybiut-mcp/
├── assets/logo-trybiut.png   🟡 logo oficial
├── docs/                     📖 TOOLS · AUTH · SECURITY · API
├── skills/trybiut/SKILL.md   🤖 skill para agentes
├── src/                      💻 index · tools · client · config
├── scripts/smoke.mjs         ✅ test de humo + invariante de seguridad
├── mcp.example.json          ⚙️ config de ejemplo
└── README.md                 👈 estás aquí

🔒 Privacidad

  • Las herramientas 🔒 exigen requireAuth() antes de cualquier red: sin login no sale ningún dato.

  • El token solo viaja a TRYBIUT_BASE_URL como Bearer, y se redacta en errores (Bearer ***).

  • Revocar el token en el dashboard corta el acceso al instante (401🔒 Login required).

🤝 Contribuir

¡PRs bienvenidos! 🎉 Ejecuta npm run build && npm run smoke antes de enviar.

📄 Licencia

MIT © 2026 TryBiut — ver 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.

ParametersJSON Schema
NameRequiredDescriptionDefault
emailNoOptional: only echoed back in the instructions, never sent anywhere.

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full behavioral disclosure burden. It does state that the tool starts registration and returns a signup link plus steps, but it does not clarify whether an account is actually created, whether this is an external redirect flow, or whether repeated calls have side effects. This is adequate but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences deliver the purpose, outcome, and return value with no filler. The most important information is front-loaded, and every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's low complexity, one optional parameter, and no output schema, the description covers the essential points: what it initiates, why, and what the caller receives. It falls slightly short of a 5 because it does not mention that the actual account creation is likely completed outside the tool via the returned signup link.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema already documents the only parameter, email, with 100% coverage, including the important note that it is only echoed and never sent. The description adds no parameter-level detail, but with full schema coverage the baseline of 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states a specific action ('Start registration') on a specific resource (trybiut.com) and explains why the user would do it ('so you can later use private tools'). It also names the expected result ('Returns the signup link + steps'), and it is easily distinguished from the sibling tools, none of which cover registration/auth.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear context for when to use the tool: when the user needs to register in order to access private tools. It does not explicitly enumerate when not to use it or name alternative tools, but no sibling tool serves the same purpose, so the guidance is sufficient.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_dashboard_taxesA

Aggregated tax dashboard of the logged-in user. Requires login (+ subscription for full data).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the behavioral disclosure burden, and it does contribute by revealing login and subscription requirements. It does not explicitly state that this is a read-only operation or describe what aggregated data is shown, leaving some behavior implicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence that front-loads the core purpose and immediately follows with access constraints. There is no filler and every phrase earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool with no output schema, the description is mostly sufficient: it names the resource, user scope, and access requirements. It could be slightly more explicit about what the aggregated data contains and that the call is read-only, but those gaps are small given the tool name and sibling context.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters and the schema already fully covers this with 100% coverage. The description adds useful context about user scoping and access requirements, but there are no parameter semantics to clarify.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly identifies this as an aggregated tax dashboard scoped to the logged-in user, distinguishing it from tax_calculate, tax_preview, tax_history, and reports_taxes in the sibling list. It lacks an explicit verb such as 'displays' or 'shows', but the noun 'dashboard' and the aggregation qualifier make the purpose unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clearly states access prerequisites: login required and subscription needed for full data, which helps an agent determine whether the user is eligible. However, it does not explicitly say when to prefer this tool over alternatives like trybiut_tax_calendar or trybiut_reports_taxes, so usage guidance is contextual but not comparative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_helpA

How to register, log in and get an API token; what works without subscription.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations at all, the description carries the full burden of disclosing behavior, and it does not explicitly state that this is a static, read-only, side-effect-free informational tool. It implies the tool returns instructional content, but for an unannotated tool the safety profile is left unstated.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

A single sentence that front-loads the main topics and end-loads the free-tier note. Every word earns its place; there is no filler or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple zero-parameter help tool with no output schema, the description covers the relevant topic domains an agent needs to know before invoking it. Slightly more detail about what the returned help content looks like would push it to a 5, but nothing essential is missing for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the baseline is 4. There is nothing for the description to explain about inputs, and the description appropriately avoids inventing parameter discussion.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description names a specific resource (help/onboarding guide) and enumerates its content: registration, login, API token acquisition, and free-tier capabilities. This clearly distinguishes it from operational siblings like trybiut_auth_register and trybiut_me, which perform the actual actions rather than explain them.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Usage context is implied — an agent can infer this is the starting point for onboarding questions — but the description never explicitly states 'use this when you need guidance on getting started or before calling operational tools.' No exclusions or alternative routing are given, though sibling names make the distinction reasonably discoverable.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_invoices_listB

List invoices of the logged-in user. Requires login. Never accessible anonymously.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo

TDQS

B3.4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the burden. It discloses that login is required and that anonymous access is impossible, which is useful behavioral context. However, it doesn't mention pagination, ordering, or what happens if the user has no invoices. The description adds some value but leaves gaps.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences, front-loaded with the main action and resource. The second sentence adds a meaningful constraint. No wasted words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple list tool with one optional parameter and no output schema, the description is mostly adequate. It covers the key access constraint (login required). However, it doesn't describe the return format or any filtering/ordering behavior, which an agent might need to know to interpret results. Given the simplicity, a 3 is fair.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. The description doesn't mention the 'limit' parameter at all, but the schema itself documents it with type, default, and bounds. Since there is only one parameter and the schema is self-explanatory, the description adds no extra meaning but the schema covers it. Baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('List') and resource ('invoices of the logged-in user'), which clearly distinguishes it from sibling tools like trybiut_movements_list or trybiut_tax_history. It doesn't explicitly name a sibling alternative, but the resource is specific enough.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives a clear context: it requires login and is never accessible anonymously. This implies it should be used when the user is authenticated and wants to see their invoices. However, it doesn't explicitly state when to prefer this over alternatives or mention any exclusions.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_meA

Verify the API token and return the logged-in user profile. Requires login.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.2/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description must carry the behavioral disclosure. It states the tool verifies a token and returns a profile, which implies a read-only operation and a login requirement. However, it does not mention potential failure modes (e.g., invalid/expired token), rate limits, or whether any side effects occur. This is a minimal but non-tautological behavioral disclosure.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two brief sentences with no filler. The core purpose is front-loaded ('Verify the API token and return the logged-in user profile'), followed by the key precondition ('Requires login'). Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool with no output schema, the description covers the essential context: what it does, the resource involved, and the login precondition. It does not detail the profile structure or error handling, but given the simplicity of the operation, the agent has enough context to invoke it correctly.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so per the rubric the baseline is 4. The description adds no parameter details, but none are needed due to the empty schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the verb ('Verify', 'return') and resource ('API token', 'logged-in user profile'), and the tool name 'me' aligns with retrieving the current user. This distinguishes it from siblings like trybiut_status (API status) and trybiut_auth_register (authentication creation).

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Requires login' clearly implies the tool is meant to be used after authentication, providing context for invocation. It does not explicitly name alternatives or exclusions, but no sibling tool appears to serve the same purpose (fetch current user profile), so the guidance is adequate.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_movements_listB

List bank/income-expense movements of the logged-in user. Requires login.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo

TDQS

B3.3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the behavioral burden. It discloses that login is required and uses the read verb 'List', which implies a read-only operation. It does not explicitly state that no side effects occur, nor does it describe output format, pagination, or limit behavior, leaving some important traits implicit.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is only two short sentences. The core operation and scope are front-loaded, and 'Requires login' is a concise, necessary precondition. There is no filler or redundant wording.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple list operation with one optional parameter, the description is nearly sufficient: an agent can call it with no arguments and know it returns a user's movements. However, with no output schema and no mention of returned fields or how 'limit' affects results, some contextual detail is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0% for the single 'limit' parameter, and the description does not mention limit, pagination, or how many movements are returned. The schema itself provides type, min, max, and default, which helps, but the description fails to compensate for the low coverage as required.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'List bank/income-expense movements of the logged-in user.' This clearly identifies what the tool does and who it applies to. However, it does not explicitly differentiate itself from siblings like invoices_list or tax_history, leaving that distinction to the resource name.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The tool's purpose implies it should be used when an agent needs the logged-in user's bank/income-expense movements, and 'Requires login' signals a prerequisite. There is no explicit when-not-to-use guidance or naming of alternative tools, so usage context is only implied rather than stated.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_pricing_countriesA

List countries covered by the pricing/market-data module. No login needed.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the disclosure burden. It explicitly states that no login is required, and 'List' indicates a read-only, non-mutating operation. It does not describe output details, but for a zero-parameter lookup this is sufficient.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences with no filler. The action is front-loaded, and the key access detail is separated cleanly. Every word earns its place.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple zero-parameter list operation, the description is complete: it identifies what is listed and states the authentication requirement. The absence of an output schema is mitigated by the low complexity and self-evident return value.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The schema has zero parameters and 100% coverage, so there are no parameter semantics that need explaining. The baseline for a no-parameter tool is 4, and the description adds no confusion.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'List' with a precise resource ('countries covered by the pricing/market-data module'), making it immediately clear what the tool returns. No sibling tool covers countries, so it is naturally distinguished.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The note 'No login needed' gives clear context on when this tool can be used: it is a public, unauthenticated lookup. None of the sibling tools overlap in function, so explicit alternatives are not necessary, though they are not named.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_reports_taxesA

Detailed tax report of the logged-in user. Requires login (+ subscription for full data).

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden of behavioral disclosure. It does reveal that access is restricted by login and that data may be incomplete without a subscription, which is useful. It does not clarify what 'full data' includes, whether any side effects exist, or what the report's shape is.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences, with the core object front-loaded and no filler words. Every clause adds meaningful information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter tool, the description covers the essential call conditions: who it applies to, login, and subscription gating. It is less explicit about the report's contents or return structure, but the absence of parameters and output schema makes this a minor gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There are zero parameters, so there is nothing the description needs to add to the input schema. The baseline of 4 for no-parameter tools applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description identifies the resource ('detailed tax report') and its scope ('of the logged-in user'), making the tool's purpose understandable. However, it does not explicitly distinguish this from sibling tax-reporting tools such as trybiut_dashboard_taxes, trybiut_tax_history, or trybiut_tax_calculate.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It gives a clear prerequisite ('Requires login') and a gating caveat ('subscription for full data'), which implies when the tool can be used. But it offers no explicit comparison to sibling tools, so an agent gets little help deciding between this and the other tax tools.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_statusA

Check that trybiut.com API is reachable. No login needed.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4.5/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full behavioral burden. It discloses the key authenticational trait ('No login needed') and implies a read-only reachability probe. It does not detail response shape or failure semantics, but for a parameterless health check this is reasonable.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences with no wasted words. The primary purpose is front-loaded, and the only additional trait worth stating, the lack of a login requirement, is included succinctly.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with no parameters, no output schema, and a very simple purpose, the description provides enough information to select and invoke it correctly. Nothing essential is missing; an agent can confidently use this as a pre-flight connectivity check.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters and schema description coverage is 100%, so the schema fully defines the input surface. The baseline for a 0-parameter tool is 4, and the description does not need to add parameter-level detail.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb ('Check') and a clear target resource ('trybiut.com API reachable'). This distinguishes it from the tax, auth, invoice, and pricing siblings, which all perform different domain operations.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It clearly communicates that no login is required, which is a useful usage prerequisite and implies this is a pre-flight connectivity check. It does not explicitly name alternatives or state when not to use it, but for a status probe the context is clear.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_subscriptionA

Check the current plan/subscription of the logged-in user. Requires login.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A4/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. 'Check' implies a read-only operation and 'Requires login' states an authentication requirement, but the description does not clarify behavior on unauthenticated requests, response format, or error cases.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two concise sentences with no filler. The core purpose is front-loaded and the login requirement is a necessary, actionable addition.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter, simple read tool, the description is largely sufficient: it states the purpose and the auth requirement. It does not describe the returned subscription shape, but no output schema exists and the resource is simple enough that an agent can infer the basic result.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The tool has zero parameters, so the baseline is 4. The description adds meaningful context by explaining that the operation targets the logged-in user, implying that identity comes from the session rather than parameters.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description uses the specific verb 'Check' and clearly identifies the resource: the current plan/subscription of the logged-in user. This is distinct from sibling tools like trybiut_status or trybiut_me, which address different concerns.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides a clear precondition ('Requires login') and implies the tool should be used when the agent needs the user's current subscription details. However, it does not explicitly compare against alternatives or state when not to use this tool.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_tax_calculateC

Basic tax breakdown for an amount/region/business type. No login needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
amountYes
periodNoannual
regionNoEspaña
businessTypeNoautonomo
includeSocialSecurityNo

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full behavioral burden. It adds 'No login needed' and the qualifier 'basic', but it does not disclose whether the calculation is read-only, whether it depends on current tax rates, whether it stores data, or what the response looks like. This is thin coverage for an unannotated tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loads the core purpose in the first sentence. The second sentence adds a useful accessibility trait. It could be more informative without being verbose, but there is no wasted wording.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a tool with five parameters, no output schema, and no annotations, this description is incomplete. It omits the role of period and includeSocialSecurity, the meaning of 'basic', the return format, and any behavior beyond 'no login'. The schema fills some gaps with defaults and enums, but not enough for reliable invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate. It names amount, region, and business type, but it does not explain 'period' or 'includeSocialSecurity' meaning, currency, or how the values interact. The schema provides names and defaults, but the description adds little beyond restating a few parameter names.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a clear purpose: producing a 'basic tax breakdown' for an amount, region, and business type. It names the core inputs and implies a calculation outcome, but it does not explicitly distinguish itself from siblings like trybiut_tax_preview or trybiut_tax_history.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance about when to use this tool versus alternatives such as trybiut_tax_preview or trybiut_tax_calendar. 'No login needed' provides a context signal but does not explain selection criteria or exclusions, leaving agents to guess which tax-related sibling fits.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_tax_calendarB

Public tax obligations calendar for a year. No login needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
yearNo

TDQS

B3/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the behavioral disclosure burden. It does disclose that the tool is public and requires no login, implying a safe read-only operation. However, it does not explicitly state that it has no side effects, nor does it describe response behavior or any rate limits.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is two short sentences with no filler, and the core purpose is front-loaded. It could be slightly more informative, but it earns its place by conveying the public, no-login nature efficiently.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a simple tool with one optional year parameter and no output schema, the description is minimally adequate: it names the resource and notes the lack of auth requirements. It is missing return-format details and any limitations/edge-case behavior, but the low complexity means this is not a critical gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

There is only one parameter, year, and schema description coverage is 0%. The description only mentions 'for a year,' which adds minimal meaning beyond the parameter name and schema constraints (default 2026, min 2020, max 2100). It does not explain the optionality or the practical effect of choosing different years beyond the obvious.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the resource ('tax obligations calendar') and scope ('for a year'), and the 'Public'/'No login needed' phrasing helps distinguish it from user-specific tax tools like trybiut_tax_calculate or trybiut_tax_history. It is not a tautology, though it never names sibling tools explicitly.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives no guidance on when to use this calendar versus alternatives such as trybiut_tax_preview, trybiut_tax_calculate, or trybiut_tax_history. 'No login needed' is a useful auth condition, but there is no when-to-use, when-not-to-use, or explicit alternative routing.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_tax_historyA

Filed tax forms history of the logged-in user. Requires login.

ParametersJSON Schema
NameRequiredDescriptionDefault

No parameters

TDQS

A3.7/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the full burden. It discloses the authentication requirement and user scoping, which is useful context. It does not explicitly state that this is a read-only operation or describe the return shape, but for a simple history query those are largely implied.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences with no filler. The core purpose is stated first, followed by the access requirement. Every word contributes.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a zero-parameter read tool with no output schema, the description covers the necessary details: what the tool returns conceptually and that authentication is required. It could add an explicit note about being read-only or listing, but nothing critical is missing for correct invocation.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has zero parameters, and the description adds no parameter-level detail. Per the baseline for 0-parameter tools, no compensation is required, so this is not a weakness.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description identifies the resource ('filed tax forms history') and the scope ('of the logged-in user'), which distinguishes it from siblings like tax_preview or tax_calculate. However, it lacks an explicit verb like 'get' or 'list', making it slightly less direct than a fully specified tool definition.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It provides a prerequisite ('Requires login') and clarifies the data is scoped to the logged-in user, which tells the agent when it is appropriate. But it does not contrast with sibling tools or state when to choose this over tax_preview or tax_calculate, so the guidance is only partial.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

trybiut_tax_previewA

Basic estimate of yearly tax savings. Public demo endpoint, no login needed.

ParametersJSON Schema
NameRequiredDescriptionDefault
incomeYesYearly income, e.g. 35000
countryNoISO country code, e.g. ES, US, DEES
legalFormNoautonomo | sl | freelance | employeeautonomo

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations, the description carries the burden and does disclose two behavioral traits: it is approximate ('basic estimate') and requires no login (public demo). It does not cover traits such as whether data is persisted, rate limits, or response shape, so it is adequate but not rich.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Two short sentences, each earning its place: the first states the function, the second the auth/demo context. Key information is front-loaded with no redundant words.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a low-complexity, one-required-parameter demo endpoint with 100% schema coverage, the description is nearly complete: it names the result, the auth requirement, and the approximate nature. There is no output schema, so a brief note on the exact return shape would make it fully complete, but the gap is minor.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

All three params are already documented in the schema with examples and defaults (income, country, legalForm). The description adds no parameter-level semantics beyond the phrase 'yearly tax savings,' so the baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific action ('estimate') on a clear resource ('yearly tax savings') and adds that it is a public demo endpoint. It is distinct from trybiut_tax_calculate in spirit, but it never names an alternative, so the differentiation is implicit rather than explicit.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

'Public demo endpoint, no login needed' gives the agent a clear condition for use: quick, unauthenticated demo calls. It implies heavier tax-calculation tools exist for authenticated or accurate work, but it does not explicitly say when-not-to-use or name the alternative.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 14 tool updatesv0.1.0
    • First observedtrybiut_auth_register
    • First observedtrybiut_dashboard_taxes
    • First observedtrybiut_help
    • First observedtrybiut_invoices_list
    • First observedtrybiut_me
    • First observedtrybiut_movements_list
    • First observedtrybiut_pricing_countries
    • First observedtrybiut_reports_taxes
    • First observedtrybiut_status
    • First observedtrybiut_subscription
    • First observedtrybiut_tax_calculate
    • First observedtrybiut_tax_calendar
    • First observedtrybiut_tax_history
    • First observedtrybiut_tax_preview

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

ActivityMaintained
ResponsivenessNo 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
    C
    maintenance
    Enables AI agents to calculate corporate tax payments, check compliance deadlines, and generate pre-filled Gibraltar company forms (annual return, office change, incorporation pack) without API keys or rate limits.
    6
    42 npm
    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
    20 npm
    4
    MIT