Skip to main content
Glama
deenesjakoruzh
Invompt

Invompt MCP

by Invompt
OverviewSchemaRelated ServersScoreDiscussions
TypeScript
Remote

Invompt MCP

Invompt MCP는 Claude Code 및 Codex를 Invompt 인보이스 도구에 온보딩하기 위한 1.0 이전 버전의 로컬 베타 패키지입니다. 이 패키지는 휴대용 스킬, 설정 CLI, Guest stdio 브리지를 제공합니다. Invompt는 인보이스 규칙, 영속성, 렌더링 및 호스팅된 문서 링크를 유지합니다.

이 소스는 invompt-mcp@0.11.2를 next 채널 전용으로 준비합니다. 릴리스, 프로덕션, 레지스트리 사용 가능성 또는 새 호스트 호환성을 보장하지 않습니다. 레지스트리 아티팩트에 의존하기 전에 외부 상태를 독립적으로 확인하십시오.

지원되는 로컬 베타 호스트

로컬 베타는 macOS Claude Code 및 Codex로 제한됩니다. 해당 패키지 매니페스트는 스킬만 노출하며, 사용자가 먼저 연결 모드를 선택해야 하므로 정적 MCP 전송을 설치하지 않습니다.

모드

전송

사용 시점

Guest

https://mcp.invompt.com/mcp로의 로컬 stdio 브리지

서버가 발급한 익명 로컬 자격 증명을 명시적으로 선택한 경우.

OAuth

https://mcp.invompt.com/mcp의 네이티브 HTTPS MCP

브라우저 로그인을 명시적으로 선택한 경우.

로컬 루프백 개발 엔드포인트는 http://localhost:3101/mcp입니다. 개발용이며 공개 호스트 기본 구성이 아닙니다. Gemini CLI 및 Qwen Code 파일은 템플릿일 뿐이며 지원되는 로컬 베타 런타임이 아닙니다.

ChatGPT 웹은 별개입니다. 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의 경우 선택한 명령 하나를 실행합니다:

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 주체입니다. 명시적 계정 청구 요청은 청구 도구를 한 번 호출하며 백엔드가 자격을 결정합니다. OAuth Guest 청구 후 권한은 연결된 상태로 유지되고 등록된 상태를 재검증합니다. 레거시 Guest 청구 후 이전 자격 증명은 GUEST_ACCOUNT_CLAIMED로 실패합니다.

마이그레이션 및 롤백

0.11.2는 nullable 업데이트 링크 복구를 추가합니다. 커밋된 update_invoice는 기능 조회가 갱신 경쟁에서 패배할 때 linkState: unavailable과 함께 url: null을 보고할 수 있으므로 업데이트를 반복하지 않고 링크를 갱신하십시오. 기존 전역 OAuth 전용 소비자를 마이그레이션하지 않습니다. 로컬 베타 모드를 의도적으로 선택하십시오. --allow-file-fallback은 setup --mode guest에서만 유효하며 알 수 없거나 중복된 플래그는 거부됩니다. 로컬 베타 상태를 롤백하려면 먼저 logout --host …를 실행하십시오. 로컬 인증 상태를 제거하고 Guest 폐기를 시도하려는 경우에만 reset --yes를 사용하십시오. 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