yellowgram

Open source

Tools

Every yellowgram tool is MIT licensed and free. Nothing here is sold. You run them; there is no support contract or SLA.

Start here

Guard every agent send. Grant each billing event once. Pin the MCP surface.

  • Current · Open source

    L2 Send Guard

    Check every send against your policy. Before it broadcasts.

    A policy guard for wallets that software controls: every signed EVM transaction is checked against a policy file you write, then simulated, before your RPC sees it. Never holds keys.

    Replaces send-allow, send-approve-bound, send-permit2-bound, send-idempotency, recv-sweep-brake and recv-approval-watch, the earlier packages now deprecated on npm. How to migrate

  • Current · Open source

    HookSteel

    Grant the credit once.

    Signed Stripe and Polar billing webhooks, a same-transaction outbox on your Postgres, and a drain that fulfills each event once.

  • Current · Open source

    SurfacePin

    Pin the surface. Catch the silent drift.

    An exact hash of an MCP server’s tools, resources, prompts, titles and instructions. When the surface changes and the pin does not, CI fails.

Agent spend & safety

Pin what an agent can call. Cap what it can spend.

  • Current · Open source

    BurnBrake

    Cap the spend. Halt the request.

    Self-hosted LLM spend brake. When the budget is gone, the next completion is refused with HTTP 402 BUDGET_EXHAUSTED (halt, not retryable).

Billing & access kits

Self-host Stripe and Polar billing pieces: webhooks once, access that matches payment, entitlement decisions, prepaid credits.

  • Current · Open source

    SeatTruth

    Reconcile both rails. Report the mismatch.

    You run this. Not a managed service. Finds paid-but-locked-out accounts, and canceled or refunded accounts that are still entitled. Read-only. No charges. No auto-fix. Stripe and Polar against your product database (is_pro / seats).

  • Current · Open source

    MayDo

    Allow the action. Decide only.

    Self-host kit. You run this. We do not operate a hosted endpoint. When your MayDo process is down, allow denies — no silent allow. Entitlement kernel: allow(actor, action), fed by verified Stripe and Polar webhooks plus local grants. The actor comes from your server's Checkout or order metadata, or an operator map. MayDo does not add a signed actor assertion.

  • Current · Open source · GitHub template

    Credit Ledger

    Run the ledger. On your Stripe.

    Empty balance stops the next expensive call on your Stripe — not only at invoice finalize. A prepaid credit ledger you copy into your app, on your own Stripe account and database.

Other

Experiments and archived code.

  • Current · Open source

    Keel

    Check the market. Recommend only.

    A read-only checker for lending WETH on Morpho against wstETH: filters markets by contract address and LLTV, runs six risk checks, compares the result with your allowlist and recommends. It never signs. It is normal for Keel to recommend holding everything idle. That means no market met the safety filters.

  • Archived · Open source

    Surface Guard

    Private-repo SurfacePin check. Archived.

    A GitHub App that ran SurfacePin verify as a private-repo PR check. Archived and unmaintained; kept as reference code. For anything maintained, use SurfacePin directly.

L2 Send Guard

Proxy, check, refuse.

A policy guard for wallets that software controls: every signed EVM transaction is checked against a policy file you write, then simulated, before your RPC sees it. Never holds keys.

01

Proxy

Point your wallet client at the local guard, or wrap your signer with the library.

02

Check

Each transaction and every call inside a batch is judged by your policy, then simulated.

03

Refuse

A denied send never reaches your RPC. Agents treat the denial as final and do not retry.

Install

npx l2-send-guard@2.1.0

yellowgram/l2-safety-proxy

HookSteel

Same transaction. Drain after commit.

Signed Stripe and Polar billing webhooks, a same-transaction outbox on your Postgres, and a drain that fulfills each event once.

Watch 60s demo

01

Record

Verified event and outbox rows, in the same Postgres transaction.

02

Deliver

Adapters run on drain after commit.

03

Keep

Duplicate deliveries ACK 200 without a second outbox row.

HTTP 400 is poison or a bad signature. HTTP 200 is accept, duplicate, or ignored. HTTP 500 is transient after verify.

Install

npm install hooksteel@0.3.0

yellowgram/hooksteel

SurfacePin

A pin, a check, a failed build.

An exact hash of an MCP server’s tools, resources, prompts, titles and instructions. When the surface changes and the pin does not, CI fails.

01

Pin

Record an exact hash of the MCP tools, resources, prompts, titles and instructions.

02

Check

Compare the live surface with the pin.

03

Fail

An unexpected change fails CI until the pin is updated.

Install

npx surfacepin@1.6.1

yellowgram/surfacepin

BurnBrake

Cap, kill, halt.

Self-hosted LLM spend brake. When the budget is gone, the next completion is refused with HTTP 402 BUDGET_EXHAUSTED (halt, not retryable).

01

Cap

User, run, and day caps, in USD.

02

Kill

Operator pause and debt gate the next reserve.

03

Halt

HTTP 402. BUDGET_EXHAUSTED. Not retryable. Never 429.

Install

npm install burnbrake@0.4.0 && npx burnbrake serve

yellowgram/burnbrake

SeatTruth

Read, diff, report.

You run this. Not a managed service. Finds paid-but-locked-out accounts, and canceled or refunded accounts that are still entitled. Read-only. No charges. No auto-fix. Stripe and Polar against your product database (is_pro / seats).

Watch 60s demo

01

Read

Read Stripe, Polar, and product is_pro / seats.

02

Diff

Findings are paid_locked_out and canceled_still_entitled. A match is silence.

03

Report

Dry-run is not all-clear. Live exit 0, 2, or 1. No charges. No auto-fix.

Install

npx seattruth@0.3.0 --dry-run

yellowgram/seattruth

MayDo

Ingest, decide, return.

Self-host kit. You run this. We do not operate a hosted endpoint. When your MayDo process is down, allow denies — no silent allow. Entitlement kernel: allow(actor, action), fed by verified Stripe and Polar webhooks plus local grants. The actor comes from your server's Checkout or order metadata, or an operator map. MayDo does not add a signed actor assertion.

01

Ingest

Verified Stripe and Polar webhooks, and local grants.

02

Decide

allow(actor, action). A boolean. When the process is down, allow denies. It does not silently allow.

03

Return

The decision only. No invoice. It does not silently allow.

Install

npm install @yellowgram/maydo@0.3.0

yellowgram/maydo

Credit Ledger

Record, draw, run.

Empty balance stops the next expensive call on your Stripe — not only at invoice finalize. A prepaid credit ledger you copy into your app, on your own Stripe account and database.

01

Record

Write credits when your Stripe account is paid. The pack catalog is the authority. metadata.credits is not.

02

Draw

check observes. reserve, then finalize or release. Or track, at most once.

03

Run

The ledger stays on your Stripe and your database. Empty is insufficient_credits. The demo returns HTTP 402.

Install

git clone https://github.com/yellowgram/stripe-credit-ledger-kit

yellowgram/stripe-credit-ledger-kit

Keel

Filter, check, recommend.

A read-only checker for lending WETH on Morpho against wstETH: filters markets by contract address and LLTV, runs six risk checks, compares the result with your allowlist and recommends. It never signs. It is normal for Keel to recommend holding everything idle. That means no market met the safety filters.

01

Filter

Keep markets with wstETH collateral, matched by contract address, and an LLTV of 86% or less.

02

Check

Borrower concentration, utilization, oracle deviation, wstETH rate, exit liquidity and freshness.

03

Recommend

One line. You decide and sign.

Install

git clone https://github.com/yellowgram/keel-morpho && cd keel-morpho && cp config.example.json config.json && python3 -m keel observe --fixture examples/fixture.json --allowlist examples/allowlist.md --out /tmp/keel-demo

yellowgram/keel-morpho

Surface Guard

A GitHub App that ran SurfacePin verify as a private-repo PR check. Archived and unmaintained; kept as reference code. For anything maintained, use SurfacePin directly.

Delivery

Archived. Not developed, sold, or hosted. Read the code on GitHub; use the SurfacePin CLI and Action for real checks.

View on GitHub

Contact

Ask about a tool

Bugs and questions go to each tool's GitHub Issues. For anything else, email hello@yellowgram.dev or use the form.

In development