Postcept MCP server
✓ VerifiziertÜberprüft Aktionen von KI-Agenten gegen Systeme of Record wie Stripe oder Zendesk, um signierte Abschlussbelege zu erhalten.
Auch bekannt als Postcept/mcp, @postcept/mcp
- Stars
- 1
- Tools
- 6
- Downloads, 30 Tage
- —
- Neueste Version
- 0.3.3
- Letzter Commit
- 1. Aug. 2026
- Lizenz
- MIT
Was ist Postcept MCP?
Überprüft Aktionen von KI-Agenten gegen Systeme of Record wie Stripe oder Zendesk, um signierte Abschlussbelege zu erhalten. Er stellt 6 Tools bereit, etwa verify_refund, verify_cancellation, verify_ticket.
Zusammenfassung generiert aus dem README des Projekts
Über Postcept MCP server
Die Hauptfunktion dieses Servers besteht darin zu verifizieren, dass hochriskante Aktionen von KI-Agenten tatsächlich in Systemen wie Stripe oder Zendesk stattgefunden haben. Er bietet Agenten eine Möglichkeit, über bloße Behauptungen der Fertigstellung hinauszugehen, indem sie signierte Belege erhalten, die beweisen, dass eine Rückerstattung, eine Kündigung eines Abonnements oder die Lösung eines Support-Tickets erfolgreich war. Dies verwandelt eine verbale Bestätigung in einen verifizierbaren Beweis.
Entwickler nutzen diesen Server als Thin Wrapper über die Postcept HTTP API, wofür eine POSTCEPT_API_KEY mit verifications:write-Berechtigungen erforderlich ist. Um die Sicherheit zu gewährleisten, arbeitet er als Read-only-Verbindung zu deinen Systemen of Record. Du kannst ihn über die POSTCEPT_BASE_URL konfigurieren, falls du eine Staging- oder selbst gehostete Umgebung nutzt. Der Server ist für die Nutzung in Clients wie Claude Desktop oder Claude Code via npx ausgelegt.
Zu den spezifischen Tools gehören verify_refund, verify_cancellation und verify_ticket, um gezielte Ergebnisse zu prüfen. Zu Testzwecken können Agenten das Flag test: true verwenden, um den Prozess gegen einen deterministischen Sandbox-Connector auszuführen. Der Server bietet außerdem get_verification zum Abrufen vergangener Belege, reconcile_verification zum erneuten Prüfen von Live-Systemen und verified_completion_rate zur Überwachung der organisatorischen Performance.
Was du damit machen kannst
- 1Agenten-Workflows sicher testenWeise den Agenten an, einen Verifizierungsflow gegen eine Sandbox anstatt gegen ein Live-Produktionssystem auszuführen.
Geschrieben aus dem README des Projekts. Jeder Use Case wurde gegen ein Zitat daraus geprüft.
So installierst du Postcept MCP
Formate geprüft am 10. Nov. 2026Zu Cursor hinzufügenZu Goose hinzufügenPostcept MCP in Claude Code installieren
$ claude mcp add --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp -- npx -y @postcept/mcpPostcept MCP in Cursor installieren
~/.cursor/mcp.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP in VS Code installieren
.vscode/mcp.json
{
"servers": {
"mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP in VS Code CLI installieren
$ code --add-mcp '{"name":"mcp","type":"stdio","command":"npx","args":["-y","@postcept/mcp"],"env":{"POSTCEPT_API_KEY":"<YOUR_POSTCEPT_API_KEY>"}}'Postcept MCP in Claude Desktop installieren
claude_desktop_config.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP in Codex installieren
$ codex mcp add mcp --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' -- npx -y @postcept/mcpPostcept MCP in Codex config.toml installieren
~/.codex/config.toml
[mcp_servers.mcp] command = "npx" args = ["-y", "@postcept/mcp"] [mcp_servers.mcp.env] POSTCEPT_API_KEY = "<YOUR_POSTCEPT_API_KEY>"
Postcept MCP in Gemini CLI installieren
$ gemini mcp add -s user -e 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp npx -- -y @postcept/mcpPostcept MCP in Gemini settings.json installieren
~/.gemini/settings.json
{
"mcpServers": {
"mcp": {
"command": "npx",
"args": [
"-y",
"@postcept/mcp"
],
"env": {
"POSTCEPT_API_KEY": "<YOUR_POSTCEPT_API_KEY>"
}
}
}
}Postcept MCP tools 6
Erkannt aus dem READMEverify_refundverify_cancellationverify_ticketget_verificationreconcile_verificationverified_completion_rate
| verify_refund | — | |
| verify_cancellation | — | |
| verify_ticket | — | |
| get_verification | — | |
| reconcile_verification | — | |
| verified_completion_rate | — |
Konfiguration
POSTCEPT_API_KEYErforderlichSecretPostcept API key
| Name | Beschreibung | Typ |
|---|---|---|
| POSTCEPT_API_KEY | Postcept API key | ErforderlichSecret |
Automatisierte Checks
Geluften am 14. Nov. 2026Vollständiger Bericht →Unsere automatisierten Checks bestanden. Das ist kein Security-Audit: Lies den Code und gib dem Server nur den minimal notwendigen Zugriff. Wie die Checks funktionieren
- Source Repository verknüpft und erreichbarpostcept/mcp is public and reachablegithub.com/postcept/mcp ↗Bestanden
- Paket nennt dieses Repository als Quelle@postcept/mcp names postcept/mcp as sourcenpmjs.com/package/@postcept/mcp ↗Bestanden
- Build-Provenienz (Sigstore-Attestierung)Sigstore attestation for @postcept/mcpnpmjs.com/package/@postcept/mcp/v/0.3.3#provenance ↗Bestanden
- Open Source Lizenz (OSI)MITspdx.org/licenses/MIT.html ↗Bestanden
- Commit oder Release im letzten JahrLast commit or release 2026-08-01github.com/postcept/mcp ↗Bestanden
- OpenSSF ScorecardNicht geprüft
- Package-Name ähnelt keinem populären PackageNo popular package one edit away from @postcept/mcpBestanden
- Keine kritischen Advisories im Paket oder seinen Abhängigkeiten99 resolved dependencies checked; no critical advisoryosv.dev ↗Bestanden
- Keine versteckten Anweisungen an das Modell6 tool descriptions and the README read; no override phrases, credential paths or hidden charactersBestanden
- Destruktive Tools sind markiertNo tool named like delete, drop or execBestanden
- Remote-Endpoint beantwortet den MCP-HandshakeNicht geprüft
README
Auf GitHub ansehen@postcept/mcp
A Model Context Protocol server that exposes Postcept, outcome verification for AI agents, as MCP tools.
After an agent performs a high-risk action (a refund, a subscription
cancellation, a support-ticket resolution), it calls a verify_* tool to confirm
the action actually completed in the system of record (Stripe, Zendesk, and more)
and obtain a signed completion receipt. "done" becomes proof, not a claim.
The server is a thin wrapper over the live Postcept HTTP API. It holds no credentials of its own beyond your Postcept API key, and verification is read-only against your systems of record.
Configuration
| Variable | Required | Default | Notes |
|---|---|---|---|
POSTCEPT_API_KEY |
yes | none | A Postcept API key (pcpt_sk_...) with verifications:write. |
POSTCEPT_BASE_URL |
no | https://api.postcept.com |
Point at a self-hosted or staging API. |
Create an API key in the Postcept dashboard under API keys.
Use with Claude Desktop / Claude Code
{
"mcpServers": {
"postcept": {
"command": "npx",
"args": ["-y", "@postcept/mcp"],
"env": { "POSTCEPT_API_KEY": "pcpt_sk_..." }
}
}
}
Tools
| Tool | Purpose |
|---|---|
verify_refund |
Verify a claimed refund (exists, amount/currency/customer match, not duplicated). |
verify_cancellation |
Verify a subscription was actually cancelled. |
verify_ticket |
Verify a support ticket is in the expected state. |
get_verification |
Fetch a past verification and its signed receipt by id. |
reconcile_verification |
Re-verify a past verification against the live system of record. |
verified_completion_rate |
Read the organization's Verified Completion Rate. |
Every verify_* tool accepts test: true to run against the deterministic
sandbox connector (excluded from your Verified Completion Rate), so an agent can
exercise the full flow without a live system of record.
A non-verified result (incomplete, duplicated, mismatched,
policy_failed) means the work is not done. Surface the gap and recover.
Advisory, by design
MCP puts the verification call in the agent's hands, which makes it the right integration for development, demos, and workflows where the agent's judgment is already trusted. It is advisory: an agent can skip the call, pass the wrong identifiers, or ignore the answer.
For consequential actions, enforce the decision outside the agent. The workflow
or orchestrator calls the Postcept API (or the SDK's guard()) itself and
branches on safe_to_claim_complete before anything customer-facing happens.
The agent then receives the allowed outcome instead of deciding it. Both
patterns use the same API and the same receipts, what changes is who owns the
branch.
Development
pnpm --filter @postcept/mcp build # compile to dist/
pnpm --filter @postcept/mcp typecheck
POSTCEPT_API_KEY=pcpt_sk_... node dist/index.js # stdio server
Postcept MCP Fragen
Wie füge ich Postcept MCP zu Claude Code hinzu?
Führe claude mcp add --env 'POSTCEPT_API_KEY=<YOUR_POSTCEPT_API_KEY>' mcp -- npx -y @postcept/mcp in deinem Terminal aus. Füge --scope user hinzu, damit der Server in jedem Projekt verfügbar ist.
Wie füge ich Postcept MCP zu Cursor hinzu?
Öffne ~/.cursor/mcp.json und füge den Server unter mcpServers hinzu, mit der Cursor-Config aus dem Installationsabschnitt oben.
Welche Tools bietet Postcept MCP?
Er stellt 6 Tools bereit, darunter verify_refund, verify_cancellation, verify_ticket, get_verification, reconcile_verification.
Wie konfiguriere ich den Postcept MCP server?
Du musst eine POSTCEPT_API_KEY und optional eine POSTCEPT_BASE_URL in deinen Umgebungsvariablen angeben.
Kann ich die Verification-Tools ohne ein Live-System of Record testen?
Ja, du kannst test: true an jedes verify_* Tool übergeben, um es gegen einen deterministischen Sandbox-Connector laufen zu lassen.
Was passiert, wenn ein Verifizierungsergebnis nicht 'verified' ist?
Wenn das Ergebnis incomplete, duplicated, mismatched oder policy_failed ist, bedeutet das, dass die Arbeit nicht tatsächlich abgeschlossen wurde.