Set pricing for your MCP server on Loomal.
Pricing on Loomal is deliberately simple: one per-call price, minimum $0.01, changed in one field whenever you like. Here's the mechanics — what the field does, what agents see, and where the money lands.
On Loomal, a price is a property of your listing, not a billing system you build. You set a per-call amount in the console; from then on, unpaid requests to your endpoint get an HTTP 402 challenge quoting that amount, agents pay it in USDC, and settlement lands on Base in about two seconds before your handler runs.
This guide walks the flow end to end: prerequisites, setting the number, what callers see, and how repricing behaves.
Prerequisites: a claimed listing and a connected server
You can only price what you control. If your server arrived on Loomal via the official registry import, the listing exists but is unclaimed — claim it through GitHub ownership verification first. Then connect the running server so the listing carries your live, probed tool list.
Connecting matters for pricing, not just discovery: agents deciding whether your price is worth paying evaluate it against your tool descriptions. A priced listing with a stale or missing tool list asks buyers to pay for a black box.
Set the per-call price
In the console, your listing has a single price field: the amount in USD charged per call, with a hard minimum of $0.01. There is no $0 option and no free per-call tier on Loomal — if you want a no-cost path for hobbyists, that's what your open-source package is for; self-hosting it stays free while the hosted, listed endpoint charges per call.
Enter the amount and save. That number becomes the quote in every subsequent 402 challenge your endpoint issues.
What the caller sees
An agent hitting your endpoint without payment receives HTTP 402 with payment requirements: the amount, the asset (USDC), and where to pay. The agent's runtime signs the payment, the facilitator verifies and settles it on Base, and only then does your tool execute. Each response carries an Ed25519-signed receipt.
The price is also published in your marketplace listing and the machine-readable index, so agents can budget for your tool before making the first request — no surprise quotes mid-task.
Repricing: one field, effective immediately
Changing your price is editing the same field again. The new amount applies to the next 402 challenge issued, and because agents always pay against a fresh quote, nobody pays an outdated price — there's no cache of old prices to invalidate or grandfathered plans to migrate.
That makes pricing experiments cheap. Raise the price for a week, compare settled revenue against the prior week in the console, and step back if volume falls more than the price rose. Treat each change as an experiment with a readable result.
Fees and where the money goes
Loomal's fee is 5% on settled transactions, and it's currently waived — so today the settled amount per call is yours. Payments settle as USDC on Base to your wallet, settlement is final, and there are no chargebacks.
Because every payment is on-chain and every call carries a signed receipt, your revenue is verifiable: what the console reports should reconcile exactly with what your wallet received, and you can check both independently.
FAQ
Can I list my server without a price, or at $0?
Your listing can exist unpriced — it shows up in search and category pages either way — but a priced call is minimum $0.01; there is no $0 per-call price on Loomal. The free path for users is your open-source distribution, which anyone can self-host at no charge.
Can I set different prices for different tools on one server?
Pricing is per listing: one per-call amount covers calls to that server. If one tool is far more expensive to serve than the rest, the practical pattern is splitting it into a separate listing with its own price rather than averaging the cost across all tools.
When does a price change take effect?
On the next 402 challenge. Agents pay against the quote in the challenge they just received, so callers always see the current price before paying and an in-flight payment settles at the amount it was quoted. There's no propagation delay you need to plan around.
What cut does Loomal take?
5% of settled transactions, currently waived. There's no listing fee or monthly platform charge — the model is a share of revenue that actually settles, and settlement is USDC on Base to your own wallet.
Put a price on it.
One field, minimum $0.01, settled in USDC on Base.