Integrates with Stripe to enable payment processing for sellers, including Connect onboarding, payout synchronization, and withdrawals via Stripe Express transfers.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Rill MCP create a pay link for $20"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Agent tools for Rill payments (Accept / Spend / Network).
Portable marketplace packaging (Agent Plugins 1.0 + Cursor/Codex manifests) lives in rillongit/agent-plugin.
Tool results wrap { ok, status, body } and append next-step hints (fund checkout, Connect URLs, receipts, shared error hints).
Mode | Entry | Default |
stdio |
| Cursor local |
HTTP |
| Railway / hosted |
HTTP routes: /mcp, /mcp/guest, /health, /ready.
Related MCP server: paas-build
See .env.example.
Variable | Purpose |
| API base (default |
| Agent virtual wallet key |
| Seller key for resources/balance/Connect |
| Supabase JWT for claim/fund/mint/seller/recycle |
|
|
|
|
| HTTP port (default 3101) |
| Require transport bearer in production |
|
|
| Shared with the API for |
Tool | Auth | Description |
| None | Catalog + happy path |
| None | Agent capabilities JSON |
| None | Resolve |
| None | List directory (defaults to payment_ready) |
| None | Curated can-pay gates (Accept + partners) |
| None (PoW) | Bootstrap |
| Owner JWT | Claim handle + account wallet |
| Owner JWT | List wallets / me |
| Owner JWT | Create |
| None | Verify receipt |
| VW | Pay any MPP/x402 HTTPS URL (primary) |
| VW | Background ledger: resource pay or FQDN transfer |
| Seller or VW | Balances + Connect flags / VW allowance |
| VW or owner JWT |
|
| Seller |
|
| Seller | Create |
| Seller | Enable MPP/x402 on gate URLs |
| Owner JWT |
|
| Owner JWT / seller |
|
| Seller |
|
| Seller | Transfer seller balance via Connect |
| Owner JWT | Seller balance → account wallet |
| Owner JWT | Refresh + probe MPP/x402 directory |
Resources: rill://docs/{authentication,money,idempotency,webhooks,errors,recipes}.
Guest HTTP (/mcp/guest): search, capabilities, resolve, list_directory, discover, register_agent, verify, fund, pay_url, pay, balance.
Seller go-live: rill_sellers list or create → rill_create_pay_link → rill_enable_payments → share gate_url → rill_webhooks payment.succeeded
Buyer (guest): rill_fund action=checkout (auto-registers) → send checkout_url to a human → poll action=intent → rill_pay_url
Buyer (owner): claim_handle → rill_fund → rill_create_wallet → rill_pay_url
Optional reach: rill_discover (curated can-pay: Accept + partners) → rill_pay_url
Background ledger (seed / A2A):
Fund → rill_pay with resource_id=SEED23 or to=<FQDN>
rill_verify_receipt; unlock seed with GET /demo/echo + X-Rill-Receipt
rill_sellers action=list (or action=create) → rill_create_pay_link → share gate_url (agents pay this; pay_page_url is the same SKU for humans)
rill_enable_payments, enables MPP + x402 (optional stripe_profile_id; defaults adopt platform profile for the seller environment)
rill_webhooks action=create for payment.succeeded, unlocks your product
Test with a funded VW via rill_pay_url against gate_url
rill_sellers action=create → save rill_sk_*
Earn via resources / pays
rill_connect action=onboard → human opens onboard_url
Poll rill_connect action=sync until connect.payouts_enabled
If stuck: rill_connect action=login
rill_withdraw (or owner rill_recycle)
Stripe model: platform Checkout on-ramp + Express Transfer off-ramp (separate charges and transfers).
pnpm --filter @rill/mcp dev
RILL_MCP_TRANSPORT=http pnpm --filter @rill/mcp dev:http
pnpm --filter @rill/mcp smoke:env
pnpm --filter @rill/mcp smoke:httpHosted HTTP: https://mcp.userill.com/mcp. Railway builds from the private monorepo using deploy/mcp/Dockerfile (clones this public repo at the SHA in deploy/mcp/submodule.sha, then builds @rill/shared + this package). apps/mcp/Dockerfile remains the local/submodule-checkout image.
This repo is the public submodule rillongit/mcp at apps/mcp. In the private monorepo, @rill/shared is resolved via the pnpm workspace.
This server cannot be deployed
Agent payments, API key vaulting, and governed mandates. Agents spend within user-defined limits.
Complete financial infrastructure for AI agents — payments, lending, escrow & more.
Paid APIs and tokenized shares for agents. Prepaid funding, including authorized Instinct checkout.
