Skip to main content
Glama
deenesjakoruzh
Invompt

Invompt MCP

by Invompt
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Invompt MCP

Invompt MCP は、Claude Code と Codex を Invompt 請求書ツールにオンボーディングするための pre-1.0 のローカルベータパッケージです。ポータブルスキル、セットアップ CLI、および Guest stdio ブリッジを提供します。Invompt は請求書ルール、永続化、レンダリング、およびホスト型ドキュメントリンクを保持します。

このソースは invompt-mcp@0.11.2 を next チャンネル専用に準備します。リリース、本番、レジストリでの利用可能性、または新しいホストとの互換性を主張するものではありません。レジストリアーティファクトに依存する前に、外部の状態を独立して確認してください。

サポートされているローカルベータホスト

ローカルベータは macOS の Claude Code と Codex に限定されます。これらのパッケージマニフェストはスキルのみを公開します。ユーザーが最初に接続モードを選択する必要があるため、静的 MCP トランスポートはインストールしません。

Mode

Transport

Use when

Guest

https://mcp.invompt.com/mcp へのローカル stdio ブリッジ

サーバー発行の仮名ローカル資格情報を明示的に選択する場合。

OAuth

https://mcp.invompt.com/mcp でのネイティブ HTTPS MCP

ブラウザサインインを明示的に選択する場合。

ローカルループバック開発エンドポイントは http://localhost:3101/mcp です。これは開発用であり、公開ホストのデフォルト設定ではありません。Gemini CLI と Qwen Code のファイルはテンプレートのみであり、サポートされているローカルベータランタイムではありません。

ChatGPT web は別です。https://mcp.invompt.com/mcp でのリモート OAuth のみです。ローカルのステータス/セットアップを実行したり、Guest ブリッジを使用したり、ローカルデバイスの状態を検査したりしてはなりません。

このリポジトリの CLI は、別のローカルベータディストリビューションです。invompt-local-beta のみを設定します。セットアップ、ログアウト、リセット、および調整は、invompt を削除または変更することはありません。Workspace Hub のグローバルコンシューマは、ホスト型 HTTPS OAuth のみの invompt プロバイダのままです。

Related MCP server: Invoices Generator MCP Server

セットアップ

Invompt MCP 呼び出しの前に、オンボーディングスキルは編集されたステータスを確認します。モードが未決定の場合、現在の会話言語で Guest または OAuth のどちらを希望するかを正確に尋ね、明示的な選択を待ちます。

Codex の場合は、選択したコマンドを 1 つ実行します:

npx --yes invompt-mcp@0.11.2 setup --host codex --mode guest
npx --yes invompt-mcp@0.11.2 setup --host codex --mode oauth

Claude Code の場合は、インストール済みキャッシュパスを想定するのではなく、同じ固定パッケージ CLI を使用します:

npx --yes invompt-mcp@0.11.2 setup --host claude-code --mode guest
npx --yes invompt-mcp@0.11.2 setup --host claude-code --mode oauth

同じ現在のホストコマンドを通じて status --json を使用して、編集された状態を検査します。ポストインストールプロンプトはなく、マニフェストやホスト設定に資格情報はありません。

結果の MCP サーバーは、両方のホストで invompt-local-beta という名前になります。通常のグローバル invompt プロバイダは、分離して OAuth のみに保ちます。

プラグインとスキルの検出は、同じ分離された名前空間を使用します: プラグイン invompt-local-beta、スキル invompt-local-beta-onboarding と invompt-local-beta-invoice。このパッケージは、グローバルプラグイン invompt またはグローバルスキル invompt-invoice、invompt-export、invompt-health として検出されません。

Guest は macOS では Keychain が優先されます（com.invompt.invompt-mcp / guest-credential）。フォールバックを明示的に許可した場合のみ、セットアップは --allow-file-fallback を追加できます。フォールバックは、~/.invompt/guest-credential（モード 0600）にある制限付き権限のプレーンテキストです。非秘密のローカル状態は ~/.invompt/auth-state.json（0700 ディレクトリ内のモード 0600）です。

Guest から OAuth への切り替えでは、Guest シークレットは休止状態のままになります。自動変換、クレーム、またはアカウントへのマージは決して行われません。意図的なホストログアウトには logout --host codex または logout --host claude-code を使用します。reset --yes はローカル状態を削除し、Guest の失効を試みます。失効がサービスに到達できない場合、コピーされた資格情報は有効なままである可能性があり、CLI はその警告を報告します。

トランスポートモードはアカウントタイプとは別です。ホスト型 OAuth Guest とレガシー資格情報 Guest はどちらも Guest プリンシパルです。明示的なアカウントクレームリクエストは、クレームツールを 1 回呼び出します。バックエンドが適格性を決定します。OAuth Guest クレームの後、グラントは接続されたままで登録状態を再検証します。レガシー Guest クレームの後、古い資格情報は GUEST_ACCOUNT_CLAIMED で失敗します。

移行とロールバック

0.11.2 は、null 許容の更新リンク回復を追加します。コミットされた update_invoice は、機能ルックアップが更新レースに負けた場合に linkState: unavailable で url: null を報告できます。そのため、更新を繰り返さずにリンクを更新します。既存のグローバル OAuth のみのコンシューマを移行しません。ローカルベータモードを意図的に 1 つ選択します。--allow-file-fallback は setup --mode guest でのみ有効であり、不明または重複したフラグは拒否されます。ローカルベータ状態をロールバックするには、最初に logout --host … を実行します。reset --yes は、ローカル認証状態を削除し、Guest の失効を試みる場合にのみ使用します。Workspace Hub コンシューマは、この CLI ではなく、独自の OAuth のみのインストーラで復元します。

障害とプライバシー

  • オフライン/ネットワーク障害および 5xx 応答は一時的な障害です。資格情報の発行をループしたり、静かに再試行したりしないでください。

  • 401 は Guest 資格情報が無効または失効していることを意味します。特に記録されたシークレットバックエンドが利用できない場合は、別のセットアップ試行の前に意図的なリセット/リカバリを使用してください。

  • 429 は Retry-After を尊重します。その前に再試行しないでください。

  • ホスト CLI エラーはセットアップを調整が必要な状態にします。ホストが設定されていると主張しないでください。

Invompt MCP は、ハードウェアまたはデバイスのフィンガープリントを導出せず、シリアルデータや MAC アドレスを収集しません。サーバー発行の Guest 資格情報は、唯一の仮名ローカル ID です。デフォルトで Keychain に保存され、デバイス ID の導出には使用されません。バンドル後はランタイム依存関係がなく、リスナーを開かず、請求書のビジネスロジックを実行しません。明示的に選択されたトランスポートを介してのみ JSON-RPC を転送し、HTTP リダイレクトを拒否します。

開発検証

正規のパッケージゲートには Node.js 22.22.0 と npm 11.11.0 を使用します:

npm ci
npm run check

チェックは、ビルド、型チェック、リント、テスト、シークレット/プライバシー回帰のためのソースとパッケージ化されたアーティファクトのスキャン、正確なパッケージ許可リストの検証、および分離された tarball のみのコンシューマのテストを行います。ローカルチェックは、外部リリースまたは新しいホストへのインストールを証明するものではありません。

Available Tools

1 tool
create_invoiceCreate InvoiceB

Create an Invompt invoice from raw IML YAML. Read invompt://spec/iml/v1 first if you need schema guidance.

ParametersJSON Schema
NameRequiredDescriptionDefault
imlYesRaw Invoice Markup Language (IML) YAML.
templateIdNoOptional template override.

Output Schema

ParametersJSON Schema
NameRequiredDescription
urlYes
invoiceIdYes

TDQS

B3.2/5.0
Behavior2/5

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

No annotations are provided, so the description carries the full burden. It mentions creating an invoice but doesn't disclose behavioral traits like permissions needed, whether the operation is idempotent, error handling, or what the output contains. The reference to external documentation adds some context but insufficiently compensates for the lack of built-in transparency.

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 concise with two sentences, front-loading the main action and following with guidance. There's no wasted text, but it could be slightly more structured by explicitly separating purpose from prerequisites.

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?

Given the tool has an output schema, the description doesn't need to explain return values. However, with no annotations and a mutation operation (create), the description lacks completeness in areas like behavioral context and usage prerequisites, making it adequate but with clear gaps for an agent to use effectively.

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 100%, so the schema already documents both parameters fully. The description adds minimal value beyond the schema by hinting at the need for schema guidance but doesn't provide additional semantics for the parameters. Baseline 3 is appropriate as the schema does the heavy lifting.

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 action ('Create an Invompt invoice') and the input source ('from raw IML YAML'), providing specific verb+resource information. However, it doesn't differentiate from siblings since there are none, and the mention of 'invompt://spec/iml/v1' adds helpful context but doesn't fully clarify the purpose beyond the basic action.

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 implies usage by referencing external schema guidance ('Read invompt://spec/iml/v1 first if you need schema guidance'), which suggests when to prepare inputs. However, it lacks explicit when-to-use guidance, alternatives, or exclusions, leaving usage context somewhat vague.

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

Install Server
RayrunBuild, deploy, and operate MCP servers without becoming an infrastructure team.ray.runAd

TDQS

B3.2/5.0
Disambiguation5/5

With only one tool, there is no possibility of ambiguity or overlap with other tools, making disambiguation perfect.

Naming Consistency5/5

A single tool inherently has consistent naming, as there are no other tools to compare it against for patterns or deviations.

Tool Count2/5

One tool is too few for a server named 'Invompt MCP', which suggests a broader invoicing domain; this feels thin and likely incomplete for typical invoicing workflows.

Completeness1/5

The server appears focused on invoicing, but with only a create_invoice tool, it lacks essential operations like retrieving, updating, listing, or deleting invoices, making it severely incomplete.

Maintenance

ActivityMaintained
ResponsivenessSyncing

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • mad-invoice-mcp

    mad-sol-dev
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables creation and management of invoices with JSON storage and LaTeX-based PDF rendering. Supports draft creation and professional PDF generation through customizable LaTeX templates.
    Apache 2.0

  • Invoice MCP Server

    kmexnx
    A
    license
    B
    quality
    D
    maintenance
    Enables the generation of professional PDF invoices and their distribution via email using customizable templates. It allows users to create, manage, and send invoices with standard business fields like tax rates and line items through natural language.
    3
    29
    2
    MIT
  • InvoiceXML by InvoiceXML

    InvoiceXMLofficial

    InvoiceXML
    A
    license
    Not graded
    quality
    C
    maintenance
    InvoiceXML brings e-invoice compliance to your AI agent. Create, validate, convert, render, and extract structured invoices across UBL (Peppol BIS Billing 3.0, used worldwide), CII, Factur-X, ZUGFeRD, and XRechnung, all checked against the EN 16931 standard and official Schematron rules. Ask your assistant to generate a compliant invoice, validate one for errors, or convert between formats, with n
    5
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Invompt/invompt-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server