Servers Playground How we check Add a server Log in

Organizze

Working · 111 ms

io.github.mcp-dir/organizze-mcpv0.1.0

Your Organizze finances in natural language: consolidated balances, monthly overview, transaction se

Finance & Payments

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.mcp.ai/p_organizze

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

tokenstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Organizze MCP server | mcptry

Organizze

Working · 111 ms

io.github.mcp-dir/organizze-mcpv0.1.0

Your Organizze finances in natural language: consolidated balances, monthly overview, transaction se

Finance & Payments

Source Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.mcp.ai/p_organizze

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

authenticate

tokenstring

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Tools (68)

authenticate

Argument	Type	Description
token	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "token": {
      "type": "string"
    }
  }
}

connect

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Argument	Type	Description
limit	number
query	string
action	string
mcp_id	string
message

organizze_add_transactions_tags

Adiciona tags a VÁRIAS transações em uma chamada (acumula sobre as existentes; máx. 200). Cada item: transaction_id ou transaction_uuid + tags (string com vírgulas ou lista).

Argument	Type	Description
items*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "tags": {
            "type": "string"
          },
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          }
        }
      }
    }
  }
}

organizze_clone_budgets

Clona os orçamentos do mês anterior para o mês de destino (não sobrescreve um mês que já tenha orçamentos). Padrão: mês atual.

Argument	Type	Description
year	number
month	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    }
  }
}

organizze_create_account

Cria uma conta bancária manual. Bulk support: accepts institution_ids for batched execution.

Argument	Type	Description
name*	string
description	string
institution_id	string
initial_balance	number
institution_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "description": {
      "type": "string"
    },
    "institution_id": {
      "type": "string"
    },
    "initial_balance": {
      "type": "number"
    },
    "institution_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

organizze_create_budget

Cria um limite de gastos (orçamento) para uma categoria. Padrão: despesa; use activity_type 'earning' para meta de receita. Prefira o NOME da categoria.

Argument	Type	Description
year	number
month	number
amount*	number
category*	string
activity_type	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "category",
    "amount"
  ],
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    },
    "amount": {
      "type": "number"
    },
    "category": {
      "type": "string"
    },
    "activity_type": {
      "type": "string"
    }
  }
}

organizze_create_category

Cria uma categoria de despesa ou receita (raiz ou subcategoria via parent_id). Bulk support: accepts group_ids, parent_ids for batched execution.

Argument	Type	Description
kind*	string
name*	string
color	string
group_id	string
group_ids	array
parent_id	number
parent_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "kind"
  ],
  "properties": {
    "kind": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "group_id": {
      "type": "string"
    },
    "group_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "parent_id": {
      "type": "number"
    },
    "parent_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_create_credit_card

Cria um cartão de crédito MANUAL (automáticos vêm da conexão bancária). As faturas são geradas automaticamente após a criação. Bulk support: accepts payment_account_ids for batched execution.

Argument	Type	Description
flag	string
name*	string
limit	number
billing_due_day*	number
billing_cycle_day*	number
payment_account_id	number
payment_account_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name",
    "billing_due_day",
    "billing_cycle_day"
  ],
  "properties": {
    "flag": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "billing_due_day": {
      "type": "number"
    },
    "billing_cycle_day": {
      "type": "number"
    },
    "payment_account_id": {
      "type": "number"
    },
    "payment_account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_create_transaction

Cria uma transação (receita ou despesa). Prefira NOMES de conta/cartão e categoria (list_accounts / list_credit_cards / list_categories primeiro se não souber). Nunca invente UUID/id. Ex.: account: "Nubank", category: "Alimentação", is_income: false.

Argument	Type	Description
date*	string
done	boolean
tags	string
times	number
amount*	number
account*	string
category	string
is_income*	boolean
recurring	boolean
description*	string
observation

organizze_create_transfer

Cria uma transferência entre duas contas bancárias (suporta recorrência). Prefira NOMES de conta (não invente ids). Não envolve cartões de crédito.

Argument	Type	Description
date*	string
done	boolean
tags	string
amount*	number
recurring	boolean
description	string
observation	string
periodicity	string
debit_account*	string
credit_account*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "amount",
    "date",
    "credit_account",
    "debit_account"
  ],
  "properties": {
    "date": {
      "type": "string"
    },
    "done": {
      "type": "boolean"
    },
    "tags": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "recurring": {
      "type": "boolean"
    },
    "description": {
      "type": "string"
    },
    "observation": {
      "type": "string"
    },
    "periodicity": {
      "type": "string"
    },
    "debit_account": {
      "type": "string"
    },
    "credit_account": {
      "type": "string"
    }
  }
}

organizze_delete_account

Exclui uma conta. ATENÇÃO: todas as transações da conta são excluídas em background. Contas automáticas não podem ser excluídas (desconecte pelo menu de conexões).

Argument	Type	Description
account*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "account"
  ],
  "properties": {
    "account": {
      "type": "string"
    }
  }
}

organizze_delete_budget

Remove um orçamento (limite de gastos) de uma categoria. Bulk support: accepts budget_ids for batched execution.

Argument	Type	Description
budget_id*	number
budget_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "budget_id"
  ],
  "properties": {
    "budget_id": {
      "type": "number"
    },
    "budget_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_delete_category

Exclui uma categoria; suas transações vão para outra categoria (substitute_category ou padrão). Categorias padrão NÃO podem ser excluídas. Ao excluir uma raiz, as subcategorias somem.

Argument	Type	Description
category*	string
substitute_category	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "category"
  ],
  "properties": {
    "category": {
      "type": "string"
    },
    "substitute_category": {
      "type": "string"
    }
  }
}

organizze_delete_credit_card

Exclui um cartão de crédito. ATENÇÃO: todas as transações e faturas do cartão são excluídas. Cartões automáticos não podem ser excluídos (desconecte pelo menu de conexões).

Argument	Type	Description
credit_card*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credit_card"
  ],
  "properties": {
    "credit_card": {
      "type": "string"
    }
  }
}

organizze_delete_transaction

Exclui uma transação. Transações automáticas (Open Finance) não podem ser excluídas. Para recorrentes use delete_recurrence. O transaction_id/uuid DEVE ser copiado de list_transactions, search_transactions ou get_transaction nesta conexão — nunca invente nem sequencie IDs. Para várias linhas, use mass_delete_transactions com filtros. Bulk support: accepts transaction_ids for batched execution.

Argument	Type	Description
transaction_id	number
transaction_ids	array
transaction_uuid	string
delete_recurrence	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "transaction_id": {
      "type": "number"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "transaction_uuid": {
      "type": "string"
    },
    "delete_recurrence": {
      "type": "string"
    }
  }
}

organizze_find_duplicates

Encontra transações possivelmente duplicadas (mesmo valor e descrição similar em datas próximas). Útil para limpeza de lançamentos em dobro. Padrão: mês atual.

read-only

Argument	Type	Description
end_date	string
start_date	string
days_threshold	number
include_automatic	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "days_threshold": {
      "type": "number"
    },
    "include_automatic": {
      "type": "boolean"
    }
  }
}

organizze_find_installments

Encontra COMPRAS PARCELADAS no período (use isto, não busca por texto). Combina parcelas estruturadas e heurística para Open Finance (apresentadas como "possível parcelamento"). Sem datas, últimos 12 meses. Pode filtrar por conta/cartão.

read-only

Argument	Type	Description
account	string
end_date	string
start_date	string
min_occurrences	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "min_occurrences": {
      "type": "number"
    }
  }
}

organizze_find_subscriptions

Detecta ASSINATURAS e serviços recorrentes (Netflix, Spotify, ChatGPT, aluguel...). Use para "minhas assinaturas", "o que pago todo mês", "o que posso cancelar". Funciona em contas/cartões CONECTADOS (Open Finance), onde não há cadastro de recorrência: combina contas fixas cadastradas e heurística (mesmo estabelecimento repetido em vários meses). Classifica por estabilidade do valor (assinatura vs recorrente variável). NÃO inclui parcelamentos (use find_installments). Sem datas, últimos 6 meses.

read-only

Argument	Type	Description
account	string
end_date	string
start_date	string
min_occurrences	number
include_recurrences	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "account": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "min_occurrences": {
      "type": "number"
    },
    "include_recurrences": {
      "type": "boolean"
    }
  }
}

organizze_get_account_context

Orientação inicial em uma só chamada: entidade conectada, plano, data de hoje no fuso do usuário, e listas compactas (id ↔ nome) de contas, cartões e categorias. Chame no início para evitar várias chamadas list_*.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_get_balances

Saldo consolidado: saldo atual de cada conta, fatura atual em aberto de cada cartão e o patrimônio (contas − faturas atuais em aberto). Base caixa; não trata parcelas/faturas futuras como dívida. Use para "qual meu saldo total", "quanto tenho", "patrimônio".

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_get_bank_connections

Lista as conexões bancárias (Open Finance / Conectado) ATIVAS e o status de cada uma (estável/indisponível). Somente leitura — não força sincronização. Use para "meu banco não atualiza".

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_get_budget_summary

Resumo dos limites de gastos do mês com alertas de budgets excedidos ou próximos do limite ("estou no controle?"). Padrão: mês atual.

read-only

Argument	Type	Description
year	number
month	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    }
  }
}

organizze_get_cashflow_forecast

Projeção de fluxo de caixa: parte do saldo atual e aplica os lançamentos não pagos de contas manuais na janela, retornando o saldo projetado ao fim e o menor ponto (risco de negativo). Base caixa; não projeta faturas de cartão. Padrão: próximos 30 dias.

read-only

Argument	Type	Description
days	number
start_date	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    }
  }
}

organizze_get_categories_evolution

Evolução de gastos/receitas por categoria ao longo do tempo (diário/semanal/mensal). Ideal para tendências. Padrão: últimos 3 meses.

read-only

Argument	Type	Description
lens	string
end_date	string
start_date	string
periodicity	string
category_ids	array
only_parent_category	boolean

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "lens": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "periodicity": {
      "type": "string"
    },
    "category_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "only_parent_category": {
      "type": "boolean"
    }
  }
}

organizze_get_categories_report

Relatório de gastos e receitas agrupados por categoria (inclui compras de cartão; base POR LANÇAMENTO). Percentuais e subcategorias. Padrão: mês atual.

read-only

Argument	Type	Description
lens	string
end_date	string
start_date	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "lens": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    }
  }
}

organizze_get_credit_card_invoice

Detalhes de uma fatura específica de cartão: transações, pagamentos e gastos por categoria. Prefira passar credit_card com o NOME do cartão. Bulk support: accepts credit_card_ids, invoice_ids for batched execution.

read-only

Argument	Type	Description
year	number
month	number
invoice_id	number
credit_card	string
invoice_ids	array
credit_card_id	number
credit_card_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    },
    "invoice_id": {
      "type": "number"
    },
    "credit_card": {
      "type": "string"
    },
    "invoice_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "credit_card_id": {
      "type": "number"
    },
    "credit_card_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_get_credit_card_invoices

Lista faturas de um cartão. Informe credit_card_id. Bulk support: accepts credit_card_ids for batched execution.

read-only

Argument	Type	Description
end_date	string
start_date	string
credit_card_id*	number
credit_card_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credit_card_id"
  ],
  "properties": {
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "credit_card_id": {
      "type": "number"
    },
    "credit_card_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_get_financial_summary

Resumo financeiro do período (receitas, despesas, comparação, maiores gastos). Totais em base caixa; maiores gastos em base por lançamento (incluem cartão) — não somam com os totais.

read-only

Argument	Type	Description
year	number
month	number
end_date	string
start_date	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    },
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    }
  }
}

organizze_get_income_vs_expenses

Relatório de entradas vs saídas (receitas vs despesas) por período, em modo cashflow. Use account_id para filtrar uma conta. Padrão: mês atual. Base caixa por conta — exclui compras individuais de cartão (só pagamentos de fatura). Bulk support: accepts account_ids for batched execution.

read-only

Argument	Type	Description
end_date	string
account_id	number
start_date	string
account_ids	array
periodicity	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "end_date": {
      "type": "string"
    },
    "account_id": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "periodicity": {
      "type": "string"
    }
  }
}

organizze_get_invoices_matrix

Matriz de faturas (mês × cartão) com totais por mês, por cartão e total geral, usando os mesmos valores de get_credit_card_invoices. Use quando o usuário pedir faturas de VÁRIOS cartões e/ou meses, em vez de somar à mão. Padrão: ano atual, todos os cartões.

read-only

Argument	Type	Description
cards	array
end_date	string
start_date	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "cards": {
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "end_date": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    }
  }
}

organizze_get_latest_imports

Transações mais recentemente importadas via Open Finance (contas/cartões conectados). Use para "lançamentos novos/recém-importados". Paginação via page/per_page (padrão 50, máx 100).

read-only

Argument	Type	Description
page	number
limit	number
per_page	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "limit": {
      "type": "number"
    },
    "per_page": {
      "type": "number"
    }
  }
}

organizze_get_monthly_overview

Visão geral do mês em uma só chamada: receitas, despesas, saldo, maiores categorias de despesa, status dos limites e contas a pagar dos próximos 7 dias. Padrão: mês atual. totals são base caixa; top_expense_categories são base por lançamento e NÃO somam com totals.expenses.

read-only

Argument	Type	Description
year	number
month	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    }
  }
}

organizze_get_open_finance_status

Status AO VIVO do agregador Open Finance (Belvo), opcionalmente por banco. Use para saber se "o banco não atualiza" é uma instabilidade upstream. Cacheado ~5 min.

read-only

Argument	Type	Description
institution	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "institution": {
      "type": "string"
    }
  }
}

organizze_get_tags_report

Relatório de transações agrupadas por tag (despesas e receitas, com percentuais). Para projetos/históricos longos informe start_date e end_date amplos — o padrão é só o mês atual.

read-only

Argument	Type	Description
end_date	string
tag_name	string
start_date	string
tag_name_prefix	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "end_date": {
      "type": "string"
    },
    "tag_name": {
      "type": "string"
    },
    "start_date": {
      "type": "string"
    },
    "tag_name_prefix": {
      "type": "string"
    }
  }
}

organizze_get_transaction

Detalhes completos de uma transação pelo id ou uuid. Bulk support: accepts transaction_ids for batched execution.

read-only

Argument	Type	Description
transaction_id	number
transaction_ids	array
transaction_uuid	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "transaction_id": {
      "type": "number"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "transaction_uuid": {
      "type": "string"
    }
  }
}

organizze_get_upcoming_bills

Contas a pagar dos próximos dias: lançamentos não pagos com vencimento na janela e faturas de cartão que vencem no período ("o que vence essa semana?"). Padrão: 7 dias.

read-only

Argument	Type	Description
days	number
start_date	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "days": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    }
  }
}

organizze_inform_invoice_payment

Informa pagamento de fatura em cartão automático (Open Finance). Bulk support: accepts invoice_date_or_ids for batched execution.

Argument	Type	Description
date	string
credit_card*	string
observation	string
invoice_date_or_id	string
invoice_date_or_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credit_card"
  ],
  "properties": {
    "date": {
      "type": "string"
    },
    "credit_card": {
      "type": "string"
    },
    "observation": {
      "type": "string"
    },
    "invoice_date_or_id": {
      "type": "string"
    },
    "invoice_date_or_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

organizze_list_accounts

Lista as contas do usuário com ids.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_list_budgets

Lista limites de gastos por categoria. Passe year e/ou month para escopo.

read-only

Argument	Type	Description
year	number
month	number

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "year": {
      "type": "number"
    },
    "month": {
      "type": "number"
    }
  }
}

organizze_list_categories

Lista as categorias usadas para classificar transações.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_list_credit_cards

Lista os cartões de crédito do usuário com ids e limites.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_list_institutions

Catálogo de instituições financeiras (bancos/operadoras) com o id (slug) usado em institution_id ao criar/editar contas e cartões. Use query para filtrar por nome.

read-only

Argument	Type	Description
limit	number
query	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number"
    },
    "query": {
      "type": "string"
    }
  }
}

organizze_list_recurrences

Lista as contas fixas CADASTRADAS (lançamentos recorrentes/infinitos): aluguel, assinaturas, salário, etc., com periodicidade, valor e a próxima ocorrência. Só traz recorrências cadastradas (contas/cartões MANUAIS); em conectados (Open Finance) volta vazio — para assinaturas use find_subscriptions. NÃO inclui parcelamentos (use find_installments).

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

organizze_list_transactions

Lista transações do usuário no período selecionado, com paginação (page/per_page; máximo 80 por página). Detalhes Open Finance (dados crus do banco) não são incluídos nesta listagem para economizar contexto; use get_transaction com o id para ver um lançamento completo. IMPORTANTE: Para análise de gastos por categoria, use list_mode='all_transactions' ou informe category_id (auto-switch). O modo 'cashflow' (padrão) mostra fluxo de caixa e NÃO inclui gastos individuais do cartão de crédito. Em cashflow, faturas Open Finance já pagas (Belvo confirmou) não aparecem na lista — o caixa realizado é o lançamento na conta (special_marker invoice_payment). Faturas em aberto aparecem como CreditCardInvoice. O modo 'all_transactions' inclui TODAS as transações incluindo gastos no cartão de crédito com suas categorias. PAGINAÇÃO: Se truncated=true, há mais itens — chame de novo com page+1 ou use filtros mais estreitos. TOTAIS: o campo period_totals já traz receitas/despesas/resultado do PERÍODO COMPLETO com o filtro atual — use-o para somas; NUNCA some as linhas de uma página truncada; para agregados mais ricos (saldo, previsto) use transactions_list_results. LIMITE: Se houver muitas transações no período, use filtros (datas, conta, categoria) ou ferramentas de relatório (ex.: get_categories_report) em vez de pedir o ano inteiro sem filtro. INTERPRETAÇÃO DO STATUS PAGO/PENDENTE: Transações de contas MANUAIS (automatic=false): 'paid' reflete se o usuário marcou como paga. Se paid=false E date < data atual → transação ATRASADA. Se paid=false E date >= data atual → transação A VENCER. Transações de contas AUTOMÁTICAS/conectadas (automatic=true): 'paid' é sempre true (banco já confirmou). IGNORE o campo paid para análise de contas atrasadas/vencendo nestas transações. Faturas de cartão (type=CreditCardInvoice): podem estar genuinamente pendentes ou atrasadas mesmo em cartões automáticos. Verifique o campo 'paid' normalmente. Bulk support: accepts account_ids, credit_card_ids, category_ids for batched execution.

read-only

Argument	Type	Description
page	number

organizze_list_transferences

Lista transferências entre contas com paginação (page/per_page). Datas em YYYY-MM-DD. Bulk support: accepts account_ids for batched execution.

read-only

Argument	Type	Description
page	number
end_date	string
per_page	number
account_id	number
start_date	string
account_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "page": {
      "type": "number"
    },
    "end_date": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "account_id": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_load_skill

Carrega um guia detalhado de uso (skill) sobre um tema do Organizze. Chame ANTES de responder quando a conversa tocar um destes temas: - automatic_card_invoice_payments: Pagamento de fatura de cartão AUTOMÁTICO (Open Finance): usuário diz que pagou a fatura de cartão conectado — fluxo inform_invoice_payment e prazos de sincronização. - bulk_transaction_operations: Operações em lote sobre transações existentes: recategorizar, atualizar descrições/tags, duplicatas e limites das ferramentas mass_* / update_transactions_*. - category_and_budget_management: Gerenciar categorias, subcategorias e orçamentos: criar, reorganizar, arquivar, mesclar, limites de gasto e reestruturação do plano de categorias. - credit_card_invoice_queries: Consultas de fatura de cartão: vencimento, fechamento, status pago/aberto e semântica de 'pago' quando a pergunta envolve despesas não pagas com cartões. - credit_card_spending: Análise de gastos no cartão de crédito: listar/filtrar compras por cartão, categorias no cartão e comparação entre faturas. - financial_health: Diagnóstico de saúde financeira: 'está tudo ok?', onde economizar, tendências de gastos — sempre incluindo cartões na análise. - financial_summaries_and_bases: Resumos financeiros do período: quanto gastei/recebi, saldo, visão geral, previsto vs. realizado e bases corretas de cálculo. - installments_search: Encontrar compras parceladas e parcelas restantes: estratégia correta com find_installments. - invoice_payments: Pagamento de fatura de cartão MANUAL: register_invoice_payment — nunca create_transaction para pagar fatura. - latest_open_finance_imports: Importações recentes Open Finance: listar novidades e marcá-las como lidas (clear_latest_imports / remove_from_latest_imports). - open_finance_accounts: Contas e cartões conectados (Open Finance): conciliação e enriquecimento de dados sincronizados sem duplicar importação. - subscriptions_detection: Detectar assinaturas e serviços recorrentes: 'o que pago todo mês', streamings repetidos, o que cancelar. - support_and_connection_issues: Suporte e problemas de conexão Open Finance: banco não atualiza/não sincroniza e canais oficiais de ajuda. - sync_accounts_and_cards: 'Sincronizar/copiar/espelhar' transações entre contas ou cartões sem duplicar (fluxo seguro anti-duplicação). - transaction_listing_and_search: Busca e listagem de transações: períodos, tags, modos list_mode (cashflow vs all_transactions), paginação e truncamento.

read-only

organizze_mass_create_transactions

Cria VÁRIAS transações em lote (máx. 100) a partir de uma lista de objetos. Use em vez de create_transaction repetido. Cada linha no array deve ser única (descrição+valor+data+conta) — dedupe no payload antes de enviar. NÃO use para importar CSV/OFX com snapshot canônico — nesse caso o app redireciona para plan_tabular_import/apply_tabular_import (error_code redirect_to_tabular); no MCP, peça ao usuário importar pelo app ou envie linhas sem fingerprint de anexo. Prefira NOMES de conta/categoria. Executa em uma chamada (sem confirmação interativa no MCP).

Argument	Type	Description
transactions*	array
idempotency_key	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "transactions"
  ],
  "properties": {
    "transactions": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description",
          "amount",
          "date",
          "account",
          "is_income"
        ],
        "properties": {
          "date": {
            "type": "string"
          },
          "done": {
            "type": "boolean"
          },
          "tags": {
            "type": "string"
          },
          "times": {
            "type": "number"
          },
          "amount": {
            "type": "number"
          },
          "account": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "is_income": {
            "type": "boolean"
          },
          "recurring": {
            "type": "boolean"
          },
          "description": {
            "type": "string"
          },
          "observation": {
            "type": "string"
          },
          "periodicity": {
            "type": "string"
          }
        }
      }
    },
    "idempotency_key": {
      "type": "string"
    }
  }
}

organizze_mass_delete_transactions

Exclui VÁRIAS transações por lista de ids/uuids (máx. 500). Os ids DEVEM vir de uma busca recente (list/search/find_duplicates/get_transaction) — nunca invente. Automáticas são ignoradas; recorrentes excluem só a ocorrência atual. Destrutivo.

Argument	Type	Description
transactions*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "transactions"
  ],
  "properties": {
    "transactions": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          }
        }
      }
    }
  }
}

organizze_mass_manage_categories

Aplica VÁRIAS mudanças na árvore de categorias em uma chamada atômica (máx. 100 ops). Operações: create, rename, move (parent '0' = raiz), archive, unarchive (NÃO há delete — use archive). Resolve por NOME (não invente ids). Se uma falhar, nada é alterado.

Argument	Type	Description
operations*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "operations"
  ],
  "properties": {
    "operations": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "op"
        ],
        "properties": {
          "op": {
            "type": "string"
          },
          "kind": {
            "type": "string"
          },
          "name": {
            "type": "string"
          },
          "color": {
            "type": "string"
          },
          "parent": {
            "type": "string"
          },
          "category": {
            "type": "string"
          },
          "group_id": {
            "type": "string"
          }
        }
      }
    }
  }
}

organizze_mass_update_transactions

Atualiza VÁRIAS transações por FILTRO de busca (máx. 200) — prefira isto a montar listas de IDs quando a mesma alteração vale para todas as linhas. Antes, valide com list_transactions/search_transactions os mesmos filtros. Informe ao menos um filtro e um campo a alterar. Prefira new_category por NOME. Conjunto vazio ou >200 devolve validation (refine filtros). Para mapa linha-a-linha use update_transactions_categories / descriptions. Irreversível em lote. Bulk support: accepts category_ids, account_ids, credit_card_ids for batched execution.

Argument	Type	Description
query	string
end_date	string
new_paid	boolean
new_tags	string
account_id	number
start_date	string
tag_action	string
tag_filter	string
account_ids	array
category_id

organizze_register_invoice_payment

Registra o pagamento de uma fatura de cartão MANUAL como lançamento, vinculado à fatura. Para cartões automáticos use inform_invoice_payment. Prefira NOMES de cartão/conta. Liste faturas com get_credit_card_invoices e passe invoice_date_or_id (id ou YYYY-MM) — nunca invente. Bulk support: accepts invoice_date_or_ids for batched execution.

Argument	Type	Description
date*	string
amount*	number
credit_card*	string
observation	string
source_account	string
invoice_date_or_id	string
invoice_date_or_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credit_card",
    "amount",
    "date"
  ],
  "properties": {
    "date": {
      "type": "string"
    },
    "amount": {
      "type": "number"
    },
    "credit_card": {
      "type": "string"
    },
    "observation": {
      "type": "string"
    },
    "source_account": {
      "type": "string"
    },
    "invoice_date_or_id": {
      "type": "string"
    },
    "invoice_date_or_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

organizze_resolve_entity

Resolve um nome aproximado para o id/uuid real de conta, cartão ou categoria. Use ANTES de uma escrita para evitar ids inventados. Quando ambíguo, retorna as correspondências.

read-only

Argument	Type	Description
kind	string
name*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "name"
  ],
  "properties": {
    "kind": {
      "type": "string"
    },
    "name": {
      "type": "string"
    }
  }
}

organizze_search_transactions

Busca transações por texto na descrição, observação ou tags (ex.: "iFood", "Uber", "salário"). Paginação via page/per_page; sem datas, o padrão são os últimos 6 meses.

read-only

Argument	Type	Description
page	number
query*	string
end_date	string
per_page	number
tags_only	boolean
max_amount	number
min_amount	number
start_date	string
activity_type	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "query"
  ],
  "properties": {
    "page": {
      "type": "number"
    },
    "query": {
      "type": "string"
    },
    "end_date": {
      "type": "string"
    },
    "per_page": {
      "type": "number"
    },
    "tags_only": {
      "type": "boolean"
    },
    "max_amount": {
      "type": "number"
    },
    "min_amount": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    },
    "activity_type": {
      "type": "string"
    }
  }
}

organizze_set_transaction_paid

Marca uma transação como paga/recebida (paid=true) ou não paga (paid=false) em conta MANUAL ("já paguei o aluguel"). Idempotente. Transações automáticas são sempre pagas. Bulk support: accepts transaction_ids for batched execution.

Argument	Type	Description
paid*	boolean
transaction_id	number
transaction_ids	array
transaction_uuid	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "paid"
  ],
  "properties": {
    "paid": {
      "type": "boolean"
    },
    "transaction_id": {
      "type": "number"
    },
    "transaction_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "transaction_uuid": {
      "type": "string"
    }
  }
}

organizze_suggest_categories

Sugere categorias para uma ou mais descrições de transação, usando as edições anteriores do próprio usuário, o histórico já categorizado e padrões globais. Use ANTES de create_transaction ao classificar um lote de descrições. Cada item retorna confidence e semantic_strength para decidir entre aplicar ou confirmar.

read-only

Argument	Type	Description
items*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "description"
        ],
        "properties": {
          "description": {
            "type": "string"
          },
          "activity_type": {
            "type": "number"
          },
          "amount_in_cents": {
            "type": "number"
          }
        }
      }
    }
  }
}

organizze_transactions_list_results

Totais financeiros de um período (receitas, despesas, resultado, saldo, previstos) sem paginar transação por transação. Ideal para "quanto gastei esse mês?", "qual meu saldo?". Padrão: mês atual. Base caixa por padrão (inclui pagamentos de fatura, não compras de cartão); com category_id muda para base por lançamento. Não reconcilie bases diferentes. Bulk support: accepts account_ids, category_ids for batched execution.

read-only

Argument	Type	Description
end_date	string
list_mode	string
account_id	number
start_date	string
account_ids	array
category_id	number
category_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "end_date": {
      "type": "string"
    },
    "list_mode": {
      "type": "string"
    },
    "account_id": {
      "type": "number"
    },
    "start_date": {
      "type": "string"
    },
    "account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "category_id": {
      "type": "number"
    },
    "category_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_uninform_invoice_payment

Desfaz um "Informar Pagamento" em cartão AUTOMÁTICO (marcador aguardando Open Finance). Não remove pagamentos reais já confirmados. invoice_date_or_id é obrigatório. Bulk support: accepts invoice_date_or_ids for batched execution.

Argument	Type	Description
credit_card*	string
invoice_date_or_id*	string
invoice_date_or_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credit_card",
    "invoice_date_or_id"
  ],
  "properties": {
    "credit_card": {
      "type": "string"
    },
    "invoice_date_or_id": {
      "type": "string"
    },
    "invoice_date_or_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

organizze_update_account

Atualiza uma conta (nome, descrição, instituição, arquivar). Contas automáticas só permitem nome e archived. Prefira NOME (não invente id). Bulk support: accepts institution_ids for batched execution.

Argument	Type	Description
name	string
account*	string
archived	boolean
description	string
hide_balance	boolean
institution_id	string
institution_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "account"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "account": {
      "type": "string"
    },
    "archived": {
      "type": "boolean"
    },
    "description": {
      "type": "string"
    },
    "hide_balance": {
      "type": "boolean"
    },
    "institution_id": {
      "type": "string"
    },
    "institution_ids": {
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  }
}

organizze_update_budget

Atualiza o valor de um orçamento existente. amount = 0 remove o orçamento. Bulk support: accepts budget_ids for batched execution.

Argument	Type	Description
amount*	number
budget_id*	number
budget_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "budget_id",
    "amount"
  ],
  "properties": {
    "amount": {
      "type": "number"
    },
    "budget_id": {
      "type": "number"
    },
    "budget_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_update_category

Atualiza uma categoria (nome, cor, pai, arquivar). Categorias padrão não podem ser excluídas, mas podem ser renomeadas/arquivadas. Prefira NOME (não invente id).

Argument	Type	Description
name	string
color	string
parent	string
archived	boolean
category*	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "category"
  ],
  "properties": {
    "name": {
      "type": "string"
    },
    "color": {
      "type": "string"
    },
    "parent": {
      "type": "string"
    },
    "archived": {
      "type": "boolean"
    },
    "category": {
      "type": "string"
    }
  }
}

organizze_update_credit_card

Atualiza um cartão de crédito (nome, bandeira, dias de fatura, limite, arquivar). Cartões automáticos só permitem nome e archived. Prefira NOME (não invente id). Bulk support: accepts payment_account_ids for batched execution.

Argument	Type	Description
flag	string
name	string
limit	number
archived	boolean
credit_card*	string
billing_due_day	number
billing_cycle_day	number
payment_account_id	number
payment_account_ids	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "credit_card"
  ],
  "properties": {
    "flag": {
      "type": "string"
    },
    "name": {
      "type": "string"
    },
    "limit": {
      "type": "number"
    },
    "archived": {
      "type": "boolean"
    },
    "credit_card": {
      "type": "string"
    },
    "billing_due_day": {
      "type": "number"
    },
    "billing_cycle_day": {
      "type": "number"
    },
    "payment_account_id": {
      "type": "number"
    },
    "payment_account_ids": {
      "type": "array",
      "items": {
        "type": "number"
      }
    }
  }
}

organizze_update_transaction

Atualiza uma transação existente (informe só os campos a alterar). Em transações automáticas só descrição, categoria, observação e tags podem mudar. Prefira NOMES de conta/categoria (não invente ids). O transaction_id/uuid DEVE ser copiado de list_transactions, search_transactions ou get_transaction nesta conexão — nunca invente nem sequencie IDs. Para várias linhas, use mass_update_transactions com filtros. Bulk support: accepts transaction_ids for batched execution.

Argument	Type	Description
date	string
paid	boolean
tags	string
amount	number
account	string
category	string
description	string
observation	string
transaction_id	number
transaction_ids	array

organizze_update_transactions_categories

Define a categoria de VÁRIAS transações em uma chamada, com destino por linha (máx. 200). Ideal após suggest_categories quando cada linha tem categoria diferente. Prefira category (NOME) e IDs só de list/suggest deste turno — nunca invente. Se a mesma categoria vale para todas, prefira mass_update_transactions com filtro.

Argument	Type	Description
updates*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "category": {
            "type": "string"
          },
          "category_id": {
            "type": "number"
          },
          "transaction_id": {
            "type": "number"
          },
          "transaction_uuid": {
            "type": "string"
          }
        }
      }
    }
  }
}

organizze_update_transactions_descriptions

Substitui a descrição de VÁRIAS transações em uma chamada (máx. 200). Cada item: transaction_id (ou id) OU transaction_uuid (ou uuid) + description (ou new_description). IDs só de list_transactions/search deste turno. Aceita um único objeto em vez de array. Se a mesma descrição/regra vale para todas, prefira mass_update_transactions.

Argument	Type	Description
updates*	array

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "updates"
  ],
  "properties": {
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "number"
          },
          "uuid": {
            "type": "string"
          },
          "description": {
            "type": "string"
          },
          "transaction_id": {
            "type": "number"
          },
          "new_description": {
            "type": "string"
          },
          "transaction_uuid": {
            "type": "string"
          }
        }
      }
    }
  }
}

report_bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Argument	Type	Description
context	string
message*	string
conversation	string

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "message"
  ],
  "properties": {
    "context": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    }
  }
}

show_version

Show the current MCP platform and adapter versions.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

toolkit_info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {}
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "limit": {
      "type": "number",
      "default": 10
    },
    "query": {
      "type": "string",
      "default": ""
    },
    "action": {
      "enum": [
        "search",
        "describe",
        "install",
        "uninstall",
        "subscribe",
        "cancel",
        "resume",
        "report_bug",
        "request_mcp",
        "list_tools",
        "invoke",
        "search_prompts",
        "get_prompt",
        "publish_prompt"
      ],
      "type": "string",
      "default": "search"
    },
    "mcp_id": {
      "type": "string",
      "default": ""
    },
    "message": {
      "type": "string",
      "default": ""
    },
    "tool_id": {
      "type": "string",
      "default": ""
    },
    "arguments": {
      "type": "string",
      "default": "{}"
    },
    "immediate": {
      "type": "boolean",
      "default": false
    },
    "tier_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_body": {
      "type": "string",
      "default": ""
    },
    "prompt_slug": {
      "type": "string",
      "default": ""
    },
    "prompt_tool": {
      "type": "string",
      "default": ""
    },
    "prompt_vars": {
      "type": "string",
      "default": "{}"
    },
    "conversation": {
      "type": "string",
      "default": "[]"
    },
    "prompt_title": {
      "type": "string",
      "default": ""
    },
    "request_name": {
      "type": "string",
      "default": ""
    },
    "cancel_reason": {
      "enum": [
        "too_expensive",
        "missing_features",
        "switched_service",
        "unused",
        "customer_service",
        "too_complex",
        "low_quality",
        "other"
      ],
      "type": "string"
    },
    "cancel_comment": {
      "type": "string",
      "default": ""
    },
    "prompt_targets": {
      "type": "array",
      "items": {
        "enum": [
          "claude",
          "chatgpt",
          "cursor",
          "lovable"
        ],
        "type": "string"
      },
      "default": []
    },
    "report_context": {
      "type": "string",
      "default": ""
    },
    "prompt_category": {
      "type": "string",
      "default": ""
    },
    "request_details": {
      "type": "string",
      "default": ""
    },
    "prompt_description": {
      "type": "string",
      "default": ""
    }
  }
}