プロトタイプ · プレビュー版:公式レジストリのすべてのサーバーを掲載し、30分ごとに同期しています。Google でログインするとレビューを書けます。プロトタイプ · 30分ごとに更新
PopNx MCPAIを使う人のためのMCPサーバー · やさしい言葉で解説

Veriko

作者:veriko-mx-labsバージョン 0.2.4i★ 0iパソコンでもクラウドでも公式サイト ↗
レジストリ名mx.veriko/veriko

インストール方法

What it does

Verifica transferencias SPEI contra el CEP de Banxico y opera la API pública de Veriko.

  • Connects パソコンでもクラウドでも
  • Account or key Cloud: Needs Authorization · Local: Needs VERIKO_API_KEY
  • Category その他

この順位の理由

これは「AI につながるアプリ」タブにあり、スターを使わず次の順で並びます

1. Claude のコネクタディレクトリにあるいいえ
2. チームが実際に試したいいえ
3. タイのユーザー向けいいえ
4. スターを除いた利用状況38/100人気 18 · 新しさ 12 · 応答中 8 · ユーザーのいいね +0
5. 登録日2026-11-15

ユーザーのいいね: 0 · 順位に最大 5 点(1 人 1 点)加算。お金では買えません。

品質: 基本チェック 5/5 項目に合格(表示のみ、並び順には不使用)

インストール

使っているAIアプリを選んで、設定をコピーしてください。

ひとことで AI にインストールしてもらう

Veriko をインストールして。https://mcp.popnx.com/i/mx-veriko-veriko.md に従い、コマンドを見せて、私が OK するまで実行しないで。

パソコンで作業できる AI(Claude Code や Cursor など)に貼り付けます。手順を読み、コマンドを見せて、あなたの OK を待ちます。キー不要・登録不要。 · AI が読む全文を見る

チェック 5/5 合格 · 質問内容は提供元のサーバー(api.veriko.mx)を通ります · ✓ コマンド確認済み 2026年11月16日

まず:どの AI を使っていますか?

使っているアプリを選ぶと、下に手順が表示されます。

Claude につなげます · 約 5 分

Veriko のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加

  1. Veriko に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Veriko のサイトを開く ↗

  2. Claude の Connectors ページを開く

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  3. 「Add」→「Custom」→「Web」を押し、この 2 つを入力

    ここからコピーして Claude の同じ名前の欄に貼り付け、Continue を押します

    Name · 名前Veriko
    Remote MCP server URL · アドレスhttps://api.veriko.mx/mcp

    Request headers に、この名前と値を追加

    ヘッダー名Authorization
    値Bearer <ここにキーを貼り付け>

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

    Claude が検出したサインイン設定の画面で Continue を押す · Authentication は作者の説明どおり(Sign in now・Sign in when needed・No sign in)を選び Add を押します

  4. チャットで有効にする

    +ConnectorsVeriko

  5. 試してみる

    Veriko を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude が Veriko を使っていると言うか、回答に Veriko のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

ChatGPT はまだ Veriko につなげません

Veriko は接続時に自分のキーが必要ですが、OpenAI のヘルプページは OAuth ログインしか説明しておらず、確認できたキー入力方法がありません

代わりにできること

A · Veriko につなげるアプリを使う

  • Veriko のキーが必要です(提供元のサイトで作成) · claude.ai かデスクトップアプリで一度設定すれば、チャットで使えます · 無料アカウントは 1 つまで · Team/Enterprise はオーナー(Owner)が追加
  • Veriko のキーが必要です(提供元のサイトで作成)
  • Veriko のキーが必要です(提供元のサイトで作成)
  • Veriko のキーが必要です(提供元のサイトで作成)

B · その他 の中で ChatGPT につなげる別のサーバー

同じカテゴリでよく使われているものから、キーなしでアドレスだけでつなげるものを選びました

Claude Code につなげます · 約 5 分

Veriko のキーが必要です(提供元のサイトで作成)

  1. Veriko に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Veriko のサイトを開く ↗

  2. ターミナルを開く

    Mac:Command+スペースで Terminal と入力 · Windows:PowerShell を開く

  3. このコマンドを貼り付けて Enter

    claude mcp add --transport http --scope user veriko https://api.veriko.mx/mcp --header 'Authorization: Bearer your-value'

    Enter の前に「your-value」を自分のキーに書き換えてください

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Claude Code で /mcp と入力

    Veriko が一覧にあり、接続済みと表示されれば OK です

  5. 試してみる

    Veriko を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Claude Code が Veriko を使っていると言うか、回答に Veriko のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Anthropic のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Cursor につなげます · 約 5 分

Veriko のキーが必要です(提供元のサイトで作成)

  1. Veriko に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Veriko のサイトを開く ↗

  2. このボタンで Cursor を開く

    Cursor で開く

    Cursor がインストールの確認をするので Install を押します

  3. キーを入力

    Veriko の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. Cursor の AI チャットを Agent モードで開く

  5. 試してみる

    Veriko を使って、私に何ができるか教えて、1 つやってみせて

    ✓ Cursor が Veriko を使っていると言うか、回答に Veriko のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に Cursor のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

VS Code につなげます · 約 5 分

Veriko のキーが必要です(提供元のサイトで作成)

  1. Veriko に登録してキーを作る

    提供元のサイトで登録し、次の手順で使う API キーを作ります。料金や無料プランは提供元のサイトで確認してください。

    Veriko のサイトを開く ↗

  2. このボタンで VS Code を開く

    VS Code で開く

    VS Code がインストールの確認をするので Install を押します

  3. キーを入力

    Veriko の設定で Authorization が空です。自分のキーを入れて保存します

    キーはアプリの入力欄にだけ貼り付け、チャットに貼ったり人に送ったりしないでください

  4. VS Code の AI チャットを Agent モードで開く

  5. 試してみる

    Veriko を使って、私に何ができるか教えて、1 つやってみせて

    ✓ VS Code が Veriko を使っていると言うか、回答に Veriko のツール名が出れば接続成功です

メニュー名は 2026年11月11日 に VS Code のヘルプページで確認 · アプリのバージョンにより画面が少し違うことがあります

Windsurf、Zed、Gemini CLI など MCP を使える他のアプリは追加方法がそれぞれ違います。アプリ一覧で確認してください

MCP を使えるアプリをすべて見る →

Web 経由でつなぐアプリ用のアドレス

アドレスhttps://api.veriko.mx/mcp

JSON 設定は下の「開発者向け」にあります

つまずいたら?Veriko を使っている人に聞いてみましょう💬 ディスカッション →
開発者向け:ターミナルのコマンドと JSON 設定

Web 経由

Claude Code

claude mcp add --transport http --scope user veriko https://api.veriko.mx/mcp --header 'Authorization: Bearer your-value'

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "veriko": {
      "url": "https://api.veriko.mx/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "veriko": {
      "type": "http",
      "url": "https://api.veriko.mx/mcp",
      "headers": {
        "Authorization": "Bearer your-value"
      }
    }
  }
}

パソコンにインストール

Claude Code

claude mcp add --scope user veriko --env VERIKO_API_KEY=your-value -- npx -y @veriko-mx/mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "veriko": {
      "command": "npx",
      "args": [
        "-y",
        "@veriko-mx/mcp"
      ],
      "env": {
        "VERIKO_API_KEY": "your-value"
      }
    }
  }
}

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "veriko": {
      "command": "npx",
      "args": [
        "-y",
        "@veriko-mx/mcp"
      ],
      "env": {
        "VERIKO_API_KEY": "your-value"
      }
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "veriko": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@veriko-mx/mcp"
      ],
      "env": {
        "VERIKO_API_KEY": "your-value"
      }
    }
  }
}

自分で入力する値

  • VERIKO_API_KEY 秘密 必須 env
    Clave de API del integrador (veriko_ seguido de 64 caracteres hexadecimales). Es opcional para las herramientas que leen datos públicos.
  • VERIKO_MCP_PROFILE env
    ツールプロファイル: core、all、またはカンマ区切りのファミリ。
    英語の原文を見るPerfil de herramientas: core, all o familias separadas por comas.
  • VERIKO_MCP_MAX_RISK env
    宣言される最大リスク: read、write、または destructive。
    英語の原文を見るRiesgo máximo que se anuncia: read, write o destructive.
  • VERIKO_BASE_URL env
    API のベース URL。localhost を除き HTTPS のみ。
    英語の原文を見るURL base de la API. Sólo HTTPS, salvo localhost.
  • VERIKO_TIMEOUT_MS env
    リクエストごとのタイムアウト時間(ミリ秒)。1000 から 300000 まで。
    英語の原文を見るTiempo límite por petición en milisegundos, de 1000 a 300000.
  • VERIKO_MAX_RETRIES env
    一時的な障害に対する自動再試行回数。0 から 5 まで。
    英語の原文を見るReintentos automáticos de fallas transitorias, de 0 a 5.
  • VERIKO_ACCEPT_LANGUAGE env
    API エラーメッセージの言語: en または es
    英語の原文を見るIdioma del texto de los errores de la API: en o es.
  • VERIKO_MCP_FILE_ROOTS env
    Directorios absolutos, separados por el delimitador de rutas de la plataforma, de los que image_path y file_path pueden leer. Sin esta variable esos argumentos no se anuncian.
  • Authorization 秘密 必須 HTTP header
    Bearer seguido de tu clave de API de Veriko

説明は自動翻訳です。変数名は原文のままです。迷ったら原文を確認してください。

この設定は、作者のレジストリ登録情報から作成しています。READMEと違う場合は、READMEに従ってください。

ひと目でわかる

週あたりのダウンロードi
614/週
確認済みドメイン
✓ veriko.mx
接続方法
パソコンでもクラウドでも
最新バージョンi
0.2.4
カテゴリi
その他
レジストリ公開日i
2026年11月16日
コードの最終更新i
2026年11月18日
最終確認
2026年11月15日
作者
veriko-mx-labs
パッケージ
npm: @veriko-mx/mcp
ウェブサイト
docs.veriko.mx
レジストリでの状態
有効

使えるアプリ

このサーバーのつなぎ方と、各アプリの公式ドキュメントに基づきます。2026年11月10日に確認。

インターネット経由でつなげるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

パソコン上で動かせるアプリ

ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast

すべてのアプリと長所・短所 →

できること

このサーバーは、ツール一覧を表示する前にサインインを求めます。

基本チェックi

誰でも見られる情報をチェックしており、コードは読んでいません。当てはまらない項目は数に入れていません。 · 2026年11月19日にチェック

  • ✓ 合格

    作者とリポジトリが一致

    レジストリ名はドメイン veriko.mx で確認済みです(レジストリがドメインの所有を確認しています)

  • ✓ 合格

    今もメンテナンスされている

    コードの最終更新:昨日

  • ✓ 合格

    ライセンスがある

    MITを使用

  • ✓ 合格

    エンドポイントが応答する

    546ミリ秒で応答(HTTP 401)

  • ✓ 合格

    OAuthでサインイン

    OAuthでのサインインに対応しているため、AIアプリがログイン画面へ案内してくれます

  • … 未チェック

    ツールの説明に隠れた指示がない

    まだチェックしていません。エンドポイントをチェックするときにツール一覧を読み取ります

公開済みの脆弱性(OSV.dev)

まだ確認していません

確認していること → · JSON

作者の方へ:再確認の依頼・情報の誤りの報告
作者向け:README にバッジを付ける

作者の方は、このコードを README に貼れます。バッジはこのページにリンクします。

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/mx-veriko-veriko.svg)](https://mcp.popnx.com/en/servers/mx-veriko-veriko)

話し合い

質問、コツの共有、使えないことの報告ができます。「役に立った」の多い順です。

まだ投稿はありません。最初の質問や共有をどうぞ。

ここの投稿は利用者によるもので、PopNx チームのものではありません。

ログインして投稿

ユーザーレビュー

まだレビューはありません

ログインしてレビューを書く

その他のほかのサーバーとの比較i

  • このカテゴリのほかの20613件のうち0%よりスターが多い
  • このカテゴリのほかの20613件のうち92%より最近レジストリに公開
  • 基本チェックの結果が、このカテゴリのほかの20613件のうち99%と同じかそれ以上

レジストリでこのカテゴリにある有効なすべてのサーバーと比較しています。スターは、公開者がリポジトリの所有者である場合だけ数えます。

よくある質問

Verikoは安全ですか?

当てはまる基本チェック5項目のうち5項目に合格しました。コードは読んでいません。キーやトークンを追加する前に、サーバーがどんなアクセスを求めているかを確認し、必要な権限だけを持つキーを使ってください。

どんなキーやコードが必要ですか?

入力が必要なもの:Authorization, VERIKO_API_KEY

パソコンで動きますか、それともクラウドですか?

どちらでも使えます。パソコンにインストールしても、クラウド版につないでもかまいません。

今もメンテナンスされていますか?

GitHubリポジトリの最終更新は昨日、最新バージョン(0.2.4)がレジストリに届いたのは3 日前です。

どのアプリで使えますか?

Claude Desktop、Claude Code、Cursor、VS CodeなどのMCP対応アプリで使えます。URL で接続するので、リモート MCP を受け付けるアプリでも使えます。例:Web 版 ChatGPT(Business 以上はフル MCP、Pro は読み取りのみ)。

代わりに使えるものは?

同じカテゴリには:World Monitor, openstatus, Oh My Posh Validator, Strata, Jitsu

似た働きのほかの候補

同じカテゴリでほかの作者のもの。コマンドは確認済み。公式を先に、次にスター順。

カードの見方:↓ 週あたりのダウンロードi★ GitHubスターi3つの柱:レビュー · チェック · 利用状況i更新=最新バージョンをレジストリに公開した日i

World Monitor

Real-time global intelligence on conflict, markets, energy, trade, shipping and cyber. 100 tools.

作者:koala73広く使われている★ 9.1万3 日前更新

クラウドで動く✓ 提供元 · worldmonitor.app

openstatus

Manage monitors, status pages, incidents and maintenances in your openstatus workspace.

作者:openstatusHQ広く使われている★ 92742 か月前更新

クラウドで動く✓ 提供元 · openstatus.dev

Oh My Posh Validator

Validate oh-my-posh configurations and segment snippets against the official schema.

作者:JanDeDobbeleer広く使われている★ 2.4万 リポジトリ全体のスター30 日前更新

クラウドで動く✓ 提供元 · ohmyposh.dev

Strata

MCP server for progressive tool usage at any scale (see https://klavis.ai)

作者:Klavis-AI成長中★ 582514 か月前更新

クラウドで動くリポジトリはアーカイブ済み✓ klavis.ai

Jitsu

Manage Jitsu data pipelines: destinations, streams, connections, functions, live events.

作者:jitsucom広く使われている★ 51354 か月前更新

クラウドで動く✓ 提供元 · jitsu.com
似たものと比べる
これ
Veriko
World MonitoropenstatusOh My Posh ValidatorStrataJitsu
動く場所クラウドでもパソコンにインストールでも使えるクラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要クラウドで動き、インストール不要
キーが必要はいいいえいいえいいえいいえいいえ
Claude で + から追加いいえいいえいいえいいえいいえいいえ
基本チェック5/54/44/44/41/44/4
ライセンスMITAGPL-3.0AGPL-3.0MITApache-2.0MIT
料金登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし登録情報に費用の記載なし

作者のREADME

READMEを開く

作者のリポジトリから書かれたとおりにコピーしたものです。PopNx MCPは内容を確認・推奨していません。HTML、画像、スクリプトは取り除いています。リンクはこのサイトの外へ移動します。

Veriko MCP

El servidor MCP de Veriko conecta Veriko con Cursor u otro cliente compatible con MCP. Le pides al asistente que compruebe un pago en el CEP de Banxico, que te diga en qué quedó una validación anterior o que descargue el comprobante.

El servidor cubre como herramientas 73 de las 75 operaciones públicas de máquina a máquina. Deja fuera las dos operaciones de purga (prepare y execute), porque un borrado definitivo no se puede deshacer. Otras tres herramientas esperan un resultado asíncrono: veriko_wait_for_validation, veriko_wait_for_cep_export y veriko_wait_for_beneficiary_import. Con eso son 76 herramientas en el perfil all.

Instalación

Hay dos formas de conectar el servidor. Con la local, tu cliente arranca el paquete en tu computadora. Con la remota, se conecta al servidor que Veriko mantiene en https://api.veriko.mx/mcp, sin instalar nada.

Local, con npx

Requiere Node.js 20 o posterior. Sin clonar nada, el cliente arranca el servidor con npx:

npx -y @veriko-mx/mcp

En Cursor y en otros editores compatibles con MCP que leen mcpServers en su archivo de configuración de MCP:

{

"mcpServers": { "veriko": { "command": "npx", "args": ["-y", "@veriko-mx/mcp"], "env": { "VERIKO_API_KEY": "veriko_..." } } } }

En VS Code (.vscode/mcp.json), que pide la clave al arrancar en lugar de guardarla en el archivo:

{

"inputs": [ { "type": "promptString", "id": "veriko-api-key", "description": "Clave de API de Veriko", "password": true } ], "servers": { "veriko": { "command": "npx", "args": ["-y", "@veriko-mx/mcp"], "env": { "VERIKO_API_KEY": "${input:veriko-api-key}" } } } }

Remota

El servidor remoto usa Streamable HTTP en https://api.veriko.mx/mcp. En Claude, ChatGPT y otros clientes que conectan con OAuth basta con la URL: el cliente te lleva a Veriko para iniciar sesión y elegir los permisos. En los demás, cada petición lleva tu clave de API en el encabezado Authorization: Bearer. Es el mismo servidor del paquete, con las mismas herramientas, pero no lee archivos de tu computadora: para image_path y file_path usa la instalación local.

En Cursor, con la clave en una variable de entorno:

{

"mcpServers": { "veriko": { "url": "https://api.veriko.mx/mcp", "headers": { "Authorization": "Bearer ${env:VERIKO_API_KEY}" } } } }

En VS Code:

{

"inputs": [ { "type": "promptString", "id": "veriko-api-key", "description": "Clave de API de Veriko", "password": true } ], "servers": { "veriko": { "type": "http", "url": "https://api.veriko.mx/mcp", "headers": { "Authorization": "Bearer ${input:veriko-api-key}" } } } }

Otros editores compatibles con MCP aceptan una URL remota y encabezados personalizados: usa la misma URL y el mismo encabezado Authorization. La clave nunca se escribe en un archivo que subas al repositorio.

Probarlo desde el código fuente

git clone https://github.com/veriko-mx-labs/veriko-mcp.git

cd veriko-mcp npm ci npm run build

Queda un servidor ejecutable en dist/index.js. Para verlo responder sin clave de API, el perfil de planes públicos no necesita credenciales:

VERIKO_MCP_PROFILE=plans VERIKO_MCP_MAX_RISK=read node dist/index.js

El proceso se queda esperando mensajes MCP por stdin; lo normal es que lo arranque tu cliente. Esta es la configuración del host, con la ruta absoluta a la copia que acabas de construir:

{

"mcpServers": { "veriko": { "command": "node", "args": ["/ruta/a/veriko-mcp/dist/index.js"], "env": { "VERIKO_API_KEY": "veriko_...", "VERIKO_MCP_PROFILE": "core", "VERIKO_MCP_MAX_RISK": "write" } } } }

La clave se obtiene en app.veriko.mx. Nunca es un argumento de una herramienta: el servidor sólo la lee de VERIKO_API_KEY, de modo que un texto inyectado en una página que el modelo esté leyendo no puede pedírsela. Las herramientas que leen datos públicos (perfil plans, estado de Banxico, catálogo de bancos) funcionan sin clave.

Variables de entorno

VariableDescripciónPredeterminado
VERIKO_API_KEYClave de API del integrador (veriko_ seguido de 64 caracteres hexadecimales)ninguno
VERIKO_MCP_PROFILEcore, all, una familia o varias familias separadas por comacore
VERIKO_MCP_MAX_RISKRiesgo máximo que se anuncia: read, write o destructivewrite
VERIKO_BASE_URLURL base de la API (HTTPS; HTTP sólo para localhost)API de producción
VERIKO_TIMEOUT_MSTiempo límite por petición, de 1,000 a 300,00060,000
VERIKO_MAX_RETRIESReintentos automáticos de fallas transitorias, de 0 a 52
VERIKO_ACCEPT_LANGUAGEIdioma del texto de los errores de la API: en o esen
VERIKO_MCP_FILE_ROOTSDirectorios absolutos, separados por el delimitador de rutas de la plataforma, de los que pueden leer image_path y file_path (sólo stdio)ninguno

Lo que consume cuota

veriko_validate_direct y veriko_validate_ocr consumen cuota del plan, que se descuenta cuando la API acepta la petición. Cada descripción lo dice, porque un ciclo de un agente puede vaciar una cuota mensual en minutos. El resultado informa el saldo restante, y el texto avisa cuando queda poco. El resto del catálogo consulta, exporta o descarga sin consumir validaciones.

Consulta antes el saldo con veriko_get_usage_limits, que pertenece al perfil core.

Perfiles

VERIKO_MCP_PROFILE acepta core, all, una familia o varias familias separadas por coma.

PerfilHerramientas anunciadas
corevalidar, validar una cuenta, listar, consultar, esperar y descargar un CEP, límites de uso
validationsciclo completo de validaciones
webhooksendpoints, entregas y secretos
catalogbancos, calendario SPEI, BIN y estado de Banxico
beneficiarieslista e importación masiva
usageconsumo, límites y exportación
accountperfil y política de reintentos
dashboardresumen operativo
plansplanes públicos
insightsmétricas agregadas
financeresúmenes, vistas previas, descargas y exportaciones de CEP
billingsuscripción activa
alllas 76 herramientas

El perfil decide qué familias ve el modelo. El riesgo se controla de forma independiente con VERIKO_MCP_MAX_RISK:

  • read: sólo consultas y descargas;
  • write (predeterminado): agrega validaciones y cambios normales;
  • destructive: agrega eliminaciones, cancelaciones, rotación de secretos y la confirmación de importaciones.
Lo que cuesta anunciar cada perfil

Anunciar una herramienta gasta contexto antes de que el modelo llame a ninguna. Estas cifras salen del propio servidor: bytes de la respuesta tools/list, con npm run measure:catalog. Los tokens son una estimación a 3.6 bytes por token, no una tokenización real, y sirven para comparar perfiles entre sí. Las cifras incluyen el esquema de salida de cada herramienta.

PerfilHerramientasBytes de tools/listTokens estimados
core826,952~7,487
validations1545,822~12,728
webhooks1029,850~8,292
catalog56,898~1,916
beneficiaries1627,784~7,718
usage79,055~2,515
account34,957~1,377
dashboard11,253~348
plans22,207~613
insights45,094~1,415
finance1221,221~5,895
billing11,087~302
all76155,218~43,116

Medido con Node 22 y riesgo destructive, para no ocultar herramientas. all cuesta 5.7 veces lo que core; por eso el perfil predeterminado es core y se amplía por familia cuando hace falta. test/tools-list-size.test.ts falla cuando un perfil rebasa su presupuesto.

Comportamiento de las herramientas

  • Nombres y entradas. Las herramientas se llaman veriko_ . El prefijo mantiene únicos los nombres en un host que conecta varios servidores, y los nombres no cambian entre versiones. Los campos de entrada usan los nombres de la API en snake_case, cada uno con su descripción, y los enums, mínimos y máximos del contrato público.
  • Salida estructurada. Cada herramienta declara un outputSchema y devuelve structuredContent más el mismo JSON como texto. Un objeto _call lleva el id de la petición, la marca Idempotent-Replayed, la cuota, la ventana de límite de frecuencia, retry_after_seconds y, cuando la API lo anuncia, deprecation y sunset. El texto se recorta a 64 KiB; structuredContent nunca se recorta.
  • Idempotencia. Cada escritura envía un Idempotency-Key aleatorio por llamada. Para reintentar sin riesgo tras una respuesta perdida, repite la llamada con la misma idempotency_key; idempotent_replayed: true significa que la API devolvió la respuesta guardada.
  • Resultados asíncronos. Una validación puede responder queued o processing. veriko_wait_for_validation, veriko_wait_for_cep_export y veriko_wait_for_beneficiary_import consultan hasta que el recurso llega a un estado terminal o termina la espera (25 segundos por omisión, hasta 40). Respetan next_poll_after_seconds y Retry-After, y responden terminal: false con el intervalo cuando se acaba el tiempo. Las lecturas condicionales que devuelven 304 llegan como { "not_modified": true, "etag": ... }, no como errores.
  • Errores. Una llamada fallida devuelve isError con code, status, retryable, retry_after_seconds, request_id y la lista completa errors (code, title, detail, hint, docs_url, pointer, meta). Un 429 por cuota agotada (kind: quota) y uno por límite de frecuencia (kind: rate_limit) regresan de inmediato, con retry_after_seconds; el servidor no espera dormido a que pasen.
  • Confirmación. Cuando el cliente declara la capacidad elicitation, el servidor pregunta antes de veriko_delete_validation, veriko_delete_webhook, veriko_regenerate_webhook_secret, veriko_delete_beneficiary, veriko_delete_beneficiary_import_row, veriko_commit_beneficiary_import, veriko_update_validation_retry_policy y veriko_update_my_retry_policy. Una pregunta rechazada o cerrada devuelve executed: false con el reason, y no se envía nada a la API. Un cliente sin la capacidad ejecuta la operación, y VERIKO_MCP_MAX_RISK sigue siendo la compuerta.
  • Avance y cancelación. Cuando la petición trae un progressToken, las herramientas de espera envían una notifications/progress por consulta, y las descargas envían una al empezar la petición y otra cuando llega el archivo. Cancelar la petición aborta la llamada en curso, sus reintentos y la pausa entre consultas; el resultado es cancelled.
  • Descargas. Los archivos regresan como recursos incrustados hasta 256 KiB, y como enlaces veriko://artifact/... por encima de eso (stdio), con el tipo MIME correcto. El servidor infiere el tipo de una descarga application/octet-stream por la extensión y los primeros bytes.
  • Límites. El servidor valida base64 canónico y los límites públicos antes de llamar al SDK: 12 MB para comprobantes OCR (imagen o PDF) y 20 MB para importaciones de beneficiarios. El transporte stdio admite completa una importación máxima.
  • Archivos locales. Por stdio, define VERIKO_MCP_FILE_ROOTS y veriko_validate_ocr acepta image_path, y veriko_create_beneficiary_import acepta file_path, en lugar de base64. La ruta debe ser absoluta y, una vez resueltos los enlaces, estar dentro de una de las raíces. El servidor revisa los límites de tamaño anteriores, los pr

冒頭だけを表示しています。続きはリポジトリで読めます