Skip to main content
Glama
deenesjakoruzh
Invompt

Invompt MCP

by Invompt
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Invompt MCP

Invompt MCP — это пакет локальной бета-версии до версии 1.0 для подключения Claude Code и Codex к инструментам счетов Invompt. Он предоставляет переносимые навыки, CLI настройки и мост Guest stdio; Invompt сохраняет правила счетов, хранение, рендеринг и размещенные ссылки на документы.

Этот исходный код готовит invompt-mcp@0.11.2 только для канала next. Он не заявляет о выпуске, производственной готовности, доступности в реестре или совместимости с новым хостом. Проверяйте внешнее состояние независимо, прежде чем полагаться на какой-либо артефакт реестра.

Поддерживаемые локальные бета-хосты

Локальная бета-версия ограничена macOS Claude Code и Codex. Их манифесты пакетов предоставляют только навыки; они не устанавливают статический транспорт MCP, поскольку пользователь должен сначала выбрать режим подключения.

Режим

Транспорт

Используйте, когда

Guest

Локальный мост stdio к https://mcp.invompt.com/mcp

Вы явно выбираете псевдонимное локальное учетное данное, выданное сервером.

OAuth

Нативный HTTPS MCP по адресу https://mcp.invompt.com/mcp

Вы явно выбираете вход через браузер.

Локальная конечная точка разработки loopback — http://localhost:3101/mcp; она предназначена для разработки, а не для публичной конфигурации по умолчанию. Файлы Gemini CLI и Qwen Code — это только шаблоны и не поддерживаются как локальные бета-среды выполнения.

ChatGPT web — отдельный: он удаленный, только OAuth, по адресу https://mcp.invompt.com/mcp. Он никогда не должен запускать локальный статус/настройку, использовать мост Guest или проверять локальное состояние устройства.

CLI этого репозитория — отдельный дистрибутив локальной бета-версии. Он настраивает только invompt-local-beta; настройка, выход, сброс и сверка никогда не удаляют и не изменяют invompt. Глобальный потребитель Workspace Hub остается одним размещенным HTTPS-провайдером invompt только с OAuth.

Related MCP server: Invoices Generator MCP Server

Настройка

Перед вызовом Invompt MCP навык онбординга проверяет отредактированный статус. Если режим не определен, он спрашивает, хотите ли вы Guest или OAuth, на языке текущего разговора, и ждет вашего явного выбора.

Для Codex выполните одну выбранную команду:

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 в первую очередь использует Keychain на macOS (com.invompt.invompt-mcp / guest-credential). Только когда вы явно разрешаете запасной вариант, настройка может добавить --allow-file-fallback; запасной вариант — это обычный текст с ограниченными правами в ~/.invompt/guest-credential (режим 0600). Несекретное локальное состояние — ~/.invompt/auth-state.json (режим 0600 в каталоге 0700).

Переключение Guest на OAuth оставляет секрет Guest неактивным. Он никогда не конвертируется автоматически, не заявляется и не объединяется в учетную запись. Используйте logout --host codex или logout --host claude-code для намеренного выхода с хоста. reset --yes удаляет локальное состояние и пытается отозвать Guest; если отзыв не может связаться со службой, скопированные учетные данные могут остаться действительными, и CLI сообщает об этом предупреждении.

Режим транспорта отделен от типа учетной записи: размещенный OAuth Guest и устаревший Guest с учетными данными — оба являются субъектами Guest. Явный запрос на заявление учетной записи вызывает инструмент заявления один раз; серверная часть решает о праве. После заявления OAuth Guest грант остается подключенным и повторно проверяет зарегистрированное состояние; после заявления устаревшего Guest старые учетные данные завершаются ошибкой GUEST_ACCOUNT_CLAIMED.

Миграция и откат

0.11.2 добавляет восстановление обнуляемой ссылки обновления: зафиксированный update_invoice может сообщать url: null с linkState: unavailable, когда поиск возможностей теряет гонку обновления, поэтому обновите ссылку, не повторяя обновление. Он не мигрирует существующего глобального потребителя только с OAuth. Выберите один режим локальной бета-версии осознанно. --allow-file-fallback допустим только с setup --mode guest, а неизвестные или дублирующиеся флаги отклоняются. Чтобы откатить состояние локальной бета-версии, сначала выполните logout --host …; используйте reset --yes только если вы также намерены удалить локальное состояние аутентификации и попытаться отозвать Guest. Восстановите потребителя Workspace Hub через его собственный установщик только с OAuth, а не через этот CLI.

Сбои и конфиденциальность

  • Сбои офлайн/сети и ответы 5xx — временные сбои; не зацикливайтесь и не повторяйте выдачу учетных данных молча.

  • 401 означает, что учетные данные Guest недействительны или отозваны; используйте осознанный сброс/восстановление перед следующей попыткой настройки, особенно если записанный секретный бэкенд недоступен.

  • 429 уважает Retry-After; не повторяйте попытку до этого.

  • Ошибка CLI хоста оставляет настройку требующей сверки; не заявляйте, что хост настроен.

Invompt MCP не получает аппаратный или устройственный отпечаток и не собирает серийные данные или MAC-адреса. Выданное сервером учетное данное Guest — единственная псевдонимная локальная идентичность; по умолчанию оно хранится в Keychain и никогда не используется для определения идентичности устройства. После сборки у него нет зависимостей времени выполнения, он не открывает слушатель и не выполняет бизнес-логику счетов. Он пересылает 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