Purser

Name: Purser
Author: ahmad-codex

von ahmad-codexVersion 0.1.2i★ –iLäuft auf deinem Computer

Name in der Registryio.github.ahmad-codex/purser

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Wallet for AI agents with on-chain spending limits and owner approval over the limit

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: Streamable HTTP
Kategorie: Sonstiges
Das musst du eintragen: PURSER_RPC_URL, PURSER_ACCOUNT, PURSER_AGENT_PRIVATE_KEY, PURSER_RELAYER_PRIVATE_KEY, PURSER_API_TOKEN

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: PURSER_RPC_URL, PURSER_ACCOUNT, PURSER_AGENT_PRIVATE_KEY, PURSER_BUNDLER_URL, PURSER_RELAYER_PRIVATE_KEY, PURSER_API_TOKEN

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

DockerDocker installiert

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "purser": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PURSER_RPC_URL",
        "-e",
        "PURSER_ACCOUNT",
        "-e",
        "PURSER_AGENT_PRIVATE_KEY",
        "-e",
        "PURSER_BUNDLER_URL",
        "-e",
        "PURSER_RELAYER_PRIVATE_KEY",
        "-e",
        "PURSER_API_TOKEN",
        "ghcr.io/ahmad-codex/purser:0.1.2"
      ],
      "env": {
        "PURSER_RPC_URL": "your-value",
        "PURSER_ACCOUNT": "your-value",
        "PURSER_AGENT_PRIVATE_KEY": "your-value",
        "PURSER_BUNDLER_URL": "your-value",
        "PURSER_RELAYER_PRIVATE_KEY": "your-value",
        "PURSER_API_TOKEN": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add purser --env PURSER_RPC_URL=your-value --env PURSER_ACCOUNT=your-value --env PURSER_AGENT_PRIVATE_KEY=your-value --env PURSER_BUNDLER_URL=your-value --env PURSER_RELAYER_PRIVATE_KEY=your-value --env PURSER_API_TOKEN=your-value -- docker run -i --rm -e PURSER_RPC_URL -e PURSER_ACCOUNT -e PURSER_AGENT_PRIVATE_KEY -e PURSER_BUNDLER_URL -e PURSER_RELAYER_PRIVATE_KEY -e PURSER_API_TOKEN ghcr.io/ahmad-codex/purser:0.1.2

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "purser": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PURSER_RPC_URL",
        "-e",
        "PURSER_ACCOUNT",
        "-e",
        "PURSER_AGENT_PRIVATE_KEY",
        "-e",
        "PURSER_BUNDLER_URL",
        "-e",
        "PURSER_RELAYER_PRIVATE_KEY",
        "-e",
        "PURSER_API_TOKEN",
        "ghcr.io/ahmad-codex/purser:0.1.2"
      ],
      "env": {
        "PURSER_RPC_URL": "your-value",
        "PURSER_ACCOUNT": "your-value",
        "PURSER_AGENT_PRIVATE_KEY": "your-value",
        "PURSER_BUNDLER_URL": "your-value",
        "PURSER_RELAYER_PRIVATE_KEY": "your-value",
        "PURSER_API_TOKEN": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "purser": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "PURSER_RPC_URL",
        "-e",
        "PURSER_ACCOUNT",
        "-e",
        "PURSER_AGENT_PRIVATE_KEY",
        "-e",
        "PURSER_BUNDLER_URL",
        "-e",
        "PURSER_RELAYER_PRIVATE_KEY",
        "-e",
        "PURSER_API_TOKEN",
        "ghcr.io/ahmad-codex/purser:0.1.2"
      ],
      "env": {
        "PURSER_RPC_URL": "your-value",
        "PURSER_ACCOUNT": "your-value",
        "PURSER_AGENT_PRIVATE_KEY": "your-value",
        "PURSER_BUNDLER_URL": "your-value",
        "PURSER_RELAYER_PRIVATE_KEY": "your-value",
        "PURSER_API_TOKEN": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

PURSER_RPC_URL erforderlich env
JSON-RPC URL of the chain the account is on
PURSER_ACCOUNT erforderlich env
Address of the Purser smart account
PURSER_AGENT_PRIVATE_KEY geheim erforderlich env
The agent's session key. The server never needs the owner key.
PURSER_BUNDLER_URL env
ERC-4337 bundler URL. Without one, the relayer key submits handleOps itself.
PURSER_RELAYER_PRIVATE_KEY geheim env
Pays for handleOps when there is no bundler. Defaults to the agent key.
PURSER_API_TOKEN geheim env
Bearer token for the approvals API and console

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto ahmad-codex bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32558 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 86 % der anderen 32558 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32558 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist Purser sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: PURSER_RPC_URL, PURSER_ACCOUNT, PURSER_AGENT_PRIVATE_KEY, PURSER_RELAYER_PRIVATE_KEY, PURSER_API_TOKEN

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.2) kam vor 5 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Docker auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, FactLot

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert gestern

Installieren

FactLot

von 9mp96ygnbk-alt

Cited CRE facts and deterministic calculators for agents: rent, CAM, debt sizing, IRR, parcel IDs.

Computer oder CloudAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

Purser

Give an AI agent a wallet without giving it your keys.

Purser is an ERC-4337 smart account where each agent gets its own session key with a policy: which contracts and functions it may call, how much it may spend per payment and per day, and until when. Payments inside the policy go through on their own. Anything over the limits waits for you to approve. An MCP server lets Claude, Cursor or any MCP client use the wallet, and a console shows budgets, spending and pending approvals as they happen.

Why

Agents are starting to pay for things: API credits, compute, data, subscriptions. Today that usually means one of two bad options:

Hand the agent a private key. One prompt injection or bug away from an empty wallet.
Approve every payment by hand. Safe, and it defeats the point of an agent.

Purser sits in between. The limits live in the contract, so they hold even if the agent, the server it runs on, or its key is compromised. The worst a leaked agent key can do is spend the rest of the current budget at allowed places, and burn some ETH on gas, until you revoke it or freeze the account, which takes one transaction. (A gas budget per key is on the roadmap.)

What's inside

Layer	What it shows
Smart contracts	ERC-4337 v0.7 account with session keys, allow-lists, per-transaction caps and rolling budgets; owner co-signature for over-limit operations; UUPS upgrades, ERC-1271, CREATE2 factory with the same address on every chain
Protocol rules	Validation that follows ERC-7562 (no clock reads), so public bundlers accept it; time-based budgets moved to the execution phase through `executeUserOp`
Testing	41 unit tests through a real EntryPoint, fuzz tests against a budget model, invariant tests with a stateful handler, gas snapshot, Slither in CI
TypeScript SDK	viem client that builds, signs and submits user operations through a bundler or `handleOps`, decodes policy errors, and indexes events within public RPC log limits
AI integration	MCP server (streamable HTTP and stdio) with six tools, model-readable refusals, and a human-in-the-loop approval flow
Product	React console with budget meters, live activity, approvals, revoke and a kill switch
Delivery	One-command demo image, Docker Compose, CI that plays the full story end to end, testnet deploy script

How it works

flowchart LR

Agent["AI agent (Claude, Cursor, ...)"] -- MCP tools --> Server["Purser server holds the session key only"] Server -- "user operation signed by the session key" --> EP["EntryPoint v0.7"] EP --> Wallet["PurserAccount policy checks"] Wallet --> Targets["Allowed contracts and recipients"] Owner["Owner"] -- "approve, reject, revoke, freeze" --> Console["Console"] Console --> Server

The owner grants an agent a session key with a policy: an allow-list of (contract, function) pairs, a per-transaction cap and a per-period budget for each token (ETH or ERC-20), and a validity window.
The agent calls MCP tools such as send_eth or call_contract. The server dry-runs the call against the policy, signs a user operation with the session key and submits it.
The account checks the signature, the window, the allow-list and the per-transaction caps during validation, so a disallowed operation fails before it costs anything. Budgets need the block time, which ERC-4337 forbids in validation, so they are enforced in executeUserOp.
Over the limit? The server turns it into an approval request. When the owner approves, the operation carries both the session signature and the owner's signature, and it runs without using the agent's budget. An approval raises the amount, never the scope: the allow-list still applies.
The owner can revoke a key or freeze the whole account at any time. A revoke or freeze earlier in the same bundle still stops a later agent operation.

Try it in one command

You need Docker. Nothing to clone, nothing to install:

docker run --rm -it -p 127.0.0.1:8787:8787 ghcr.io/ahmad-codex/purser:demo

The container starts a local chain, deploys the EntryPoint, the factory and a fresh account with a seeded agent, and starts the MCP server and the console. Open http://localhost:8787 and watch: ten seconds later the agent story plays in the terminal while the console updates live.

The agent pays a merchant, pays in a token, buys from a shop contract, tries a payment over the limit (the approval request appears in the console), gets approved, is refused for a recipient that is not on its allow-list, and is stopped by the kill switch. Then the wallet stays up for your own agent. Everything uses Anvil's public development keys and is gone when you press Ctrl+C.

From a clone, docker compose up runs the same stack as separate services, and docker compose run --rm demo plays the story against it.

Connect your own agent

With the demo running, point any MCP client at http://localhost:8787/mcp:

claude mcp add --transport http purser http://localhost:8787/mcp

Then ask Claude: *"Check the wallet status, then pay the merchant 0.01 ETH for API credits."* Try *"pay the merchant 0.3 ETH"* to see an approval request show up in the console. docs/mcp-clients.md covers Claude Desktop, Cursor and stdio.

MCP tools

Tool	What it does
`wallet_status`	Balances, the agent's remaining budget per token, caps, reset times, expiry, freeze state, pending approvals
`send_eth`	Pay ETH to an address or a known name
`send_token`	Pay ERC-20 tokens by symbol or address
`call_contract`	Call an allowed contract function, optionally with ETH, e.g. `buy(uint256)`
`get_request`	Status of an approval request
`list_requests`	Recent approval requests

Each payment tool returns one of: done (with the transaction hash and the budget left), waiting for the owner (with the request id), or refused (with a reason the model can act on).

The policy

Field	Meaning
`permissions`	`(target, selector)` pairs. `0xffffffff` allows any function on a target; `0x00000000` allows plain ETH transfers. The account itself can never be a target.
`limits`	Per token (`address(0)` is ETH): `perTx` cap and `perPeriod` budget. ERC-20 `transfer`, `approve` and `transferFrom` from the account count as spending.
`period`	Budget window in seconds, for example `86400` for a daily budget.
`validAfter`, `validUntil`	When the key works. Enforced by the EntryPoint through the validation data.

Granting a key again replaces its whole policy; old permissions do not leak into the new one.

Contracts

Contract	Purpose
`PurserAccount`	The account: ERC-4337 v0.7, UUPS upgradeable by its owner, ERC-1271, token callbacks
`PurserFactory`	CREATE2 factory, so an account's address is known before it is deployed

Built on the eth-infinitism reference EntryPoint v0.7 and OpenZeppelin 5. The factory deploys through the deterministic CREATE2 proxy, so it has the same address on every chain with the canonical EntryPoint.

Tests. 41 unit tests through a real EntryPoint, fuzz tests that check random payment and time sequences against a model of the budget, and invariant tests (about 16,000 random calls per run) for three properties: an agent never spends more than its budget per period without approval, a revoked key never moves funds again, and the policy never changes behind the owner's back. Slither runs in CI. See docs/security.md for the threat model.

Deployments. See docs/deployments.md.

Repository layout

contracts/        Foundry project: PurserAccount, factory, tests, deploy and demo scripts

packages/sdk/ TypeScript client on viem: build, sign and send user operations, read state packages/server/ MCP server (HTTP and stdio), approvals API, serves the console apps/console/ React console for the owner scripts/ local-up.sh, deploy-testnet.sh, demo.ts, demo-entrypoint.sh Dockerfile.demo all-in-one demo image (chain, contracts, server, console) docs/ architecture, security, MCP clients, deployments

Development

npm install

cd contracts && forge test # unit, fuzz and invariant tests cd .. && npm test # TypeScript unit tests ./scripts/local-up.sh # Anvil + deploy + demo account, writes .env.local npm run build -w @purser/console npm run server # console and MCP on http://localhost:8787 npm run demo # the end-to-end story; CI runs it too

No Foundry installed? contracts/forge.sh forge test runs it from the official Docker image, and scripts/local-up.sh falls back to Docker on its own.

To deploy to Base Sepolia or Sepolia, see docs/deployments.md: one script, and a faucet drip of under 0.01 ETH covers everything.

Status

Early, version 0.1.2. Not audited. Use testnets, and do not put real funds in an account you have not reviewed yourself. What is planned next is in ROADMAP.md, and issues labelled good first issue are a good place to start contributing.

Contributing

See CONTRIBUTING.md. Security reports go through private advisories, not issues.

License

MIT

Purser

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

FactLot

README vom Entwickler

Purser

Why

What's inside

How it works

Try it in one command

Connect your own agent

MCP tools

The policy

Contracts

Repository layout

Development

Status

Contributing

License