dev.rohnelt.auraPublished by aura.rohnelt.devOfficial publisherv0.1.1Updated Oct 27, 2026
Email address, webhook, durable memory and zero-token waiting for agents. Paid in USDC via x402.
Remote MCP service giving AI agents a real email address, webhook URL, durable memory and event waiting, paid per call in USDC.
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/dev.rohnelt.aura%2Faura/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"aura": {
"type": "http",
"url": "https://aura.rohnelt.dev/mcp"
}
}
}The persistence layer for ephemeral agents. A real email address, a webhook URL, durable memory, and the ability to wait for an event without burning tokens — sold to autonomous agents that pay in USDC over x402, with no account and no human in the loop.
Service: https://aura.rohnelt.dev · MCP: https://aura.rohnelt.dev/mcp · Docs for models: llms-full.txt
This repository holds the client side: SDKs, framework adapters, and the Claude Skill.
An autonomous agent is ephemeral. That creates three hard blockers, and none of them is a matter of intelligence:
Aura removes all three. An agent proves it controls a wallet with one signature and gets a handle, a real mailbox, a webhook base URL, durable memory, and two ways to wait.
Or point any MCP client at the endpoint:
Without the header the tools still list, and capabilities and identity_create still work — an agent can evaluate the service before committing to anything.
Fourteen tools, each described for a model deciding whether to spend money: what it does, when not to use it, and what it costs.
Operations cost fractions of a cent, so they are debited off-chain from a prepaid balance: one on-chain settlement covers hundreds of calls. Claiming an identity is free and grants a small trial credit.
Two of these refund themselves: a timed-out await costs nothing, and resume is free when no parked work is ready. So calling resume at the start of every run is safe.
Deposits are paid in USDC on Base: POST /v1/credit/deposit/{1,5,20} answers HTTP 402 with full x402 payment requirements.
An agent has no human to ask, so every error returns what was missing and the corrected call. A 402 carries the exact deposit call; a memory 404 carries the keys that do exist; a 400 carries the schema plus a working example. Both SDKs preserve that rather than flattening it into a string.
Aura is built to be found and evaluated by a machine, without a signup:
/v1/capabilities — every operation, price and schema. Free./llms.txt and /llms-full.txt/openapi.json — OpenAPI 3.1/.well-known/x402, /.well-known/agent.json, /.well-known/mcp.jsonGET / returns JSON unless Accept explicitly asks for HTML.
MIT
Source: README.md at commit da6a0fc
Describe Aura
Return the full machine-readable manifest of Aura: every operation, its price in USD, its input schema and how to pay. Free. When to use: Call this first if you have never used Aura and want to know what it can do and what it costs. Price: Free.
Takes no parameters.
Claim an identity
Turn a wallet address into a permanent agent identity: a handle, a REAL email address that receives mail, a webhook URL, and an API token. Free, and grants a small trial credit. When to use: Call this once, before anything else. You need the returned token for every other call, and the email address is what lets you sign up for third-party services. Price: Free.
labelwalletrequiredmessagerequiredsignaturerequiredWho am I
Return your handle, email address, webhook base URL, current balance and quota usage. Free. When to use: Call when you need your own email address, or to check your balance before spending. Price: Free.
Takes no parameters.
Top up balance
Pay USDC once and receive spendable Aura credit. Individual calls are far too cheap to settle on-chain one at a time, so you deposit once and Aura debits each call off-chain. When to use: Call when your balance is low, or when a paid call returns 402. A US$1 deposit covers hundreds of operations. Price: Free.
amount_usdRemember something
Store a durable key/value fact bound to your wallet. Survives your process dying. When to use: Call whenever you learn something a later run will need: a decision, where a credential lives, a user preference, progress through a long task. Price: US$0.000800 per call.
keyrequiredtagsvaluerequiredttl_secondsRecall by key
Fetch one stored value by its exact key. When to use: Call when you know the key you wrote earlier. Cheaper and more precise than memory.search. Price: US$0.000500 per call.
keyrequiredSearch memory
Find stored memories by meaning rather than by exact key. When to use: Call when you remember roughly what you stored but not the key you used. Price: US$0.002000 per call.
qrequiredtaglimitList memory keys
List your stored keys with metadata, without returning the values. When to use: Call to see what you already know before deciding what to fetch. Price: US$0.000500 per call.
limitprefixForget
Delete a stored key. Free — keeping your own state tidy should never cost you. When to use: Call when a stored fact is stale or wrong. Price: Free.
keyrequiredList received mail
List messages delivered to your Aura email address, newest first. When to use: Call after signing up somewhere, to see what arrived. To block until mail lands, use await instead — it is far cheaper than polling this. Price: US$0.001000 per call.
fromlimitunread_onlyRead a message
Return the full parsed body of one message, plus any verification code or confirmation link found in it. When to use: Call with an id from inbox.list when you need the full text or the link. Price: US$0.001000 per call.
idrequiredCreate a webhook URL
Mint a public URL that anyone can POST to. Deliveries become events you can await on. When to use: Call when a third-party service offers a callback and you have nowhere to receive it — you are not a server, Aura is. Price: US$0.001000 per call.
slugrequireddescriptionSignal another agent
Send a named JSON message to another Aura agent by handle. They can await on it. When to use: Call to hand work to, or coordinate with, another agent without shared infrastructure. Price: US$0.002000 per call.
torequirednamepayloadWait for something (burns zero tokens)
Block on an open HTTP connection until a trigger fires — an email arrives, a webhook is hit, another agent signals you, or a deadline passes. Returns the instant it happens. If nothing fires before the timeout, the call is refunded: you are only charged when something is actually delivered. When to use: Call INSTEAD of polling in a loop. A poll loop costs a full inference per iteration; waiting inside this single call costs you nothing beyond the flat fee. Use it for verification codes, callbacks and approvals that land within minutes. Price: US$0.004000 per call. This call blocks until it resolves; waiting inside it costs you no tokens.
onrequiredtimeout_secondslookback_secondsPark state and exit
Hand Aura your state plus a wake condition, then terminate. Aura holds the state, watches for the condition, and returns it byte-identical when you come back with resume. Optionally POSTs to a callback URL when it fires. When to use: Call when the wait outlasts your process — hours, days, or an approval that lands tomorrow. Cheaper and safer than staying alive. Price: US$0.005000 per call.
onrequirednotestaterequiredcallback_urlexpires_in_hoursResume parked work
Claim state from a park whose trigger has fired. Returns the original state and the event that woke it. Free when nothing is ready, so calling it at the start of every run costs you nothing until it actually hands work back. When to use: Call at the START of every run. If a previous instance of you parked something and it fired, this hands the work back. If nothing is ready it tells you so, cheaply. Price: US$0.002000 per call. This call blocks until it resolves; waiting inside it costs you no tokens.
park_idwait_seconds100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
npm install aura-agent # JavaScript / TypeScriptpip install aura-x402 # Python{ "mcpServers": { "aura": { "type": "http", "url": "https://aura.rohnelt.dev/mcp", "headers": { "Authorization": "Bearer aura_sk_..." } } }}from aura_agent import Aura, LocalSigner
client = Aura.claim(LocalSigner(private_key)) # free, one signature, no signupaddress = client.whoami()["email"] # a real mailbox
sign_up_somewhere(email=address) # whatever the task actually iscode = client.await_email_code() # blocks; costs no tokens; refunds on timeoutimport { Aura, toSigner } from "aura-agent";import { privateKeyToAccount } from "viem/accounts";
const { client, identity } = await Aura.claim(toSigner(privateKeyToAccount(key)));const code = await client.awaitEmailCode({ from: "[email protected]" });from aura_agent.langchain import get_tools # pip install "aura-x402[langchain]"from aura_agent.crewai import get_tools # pip install "aura-x402[crewai]"
tools = get_tools(client)try: client.remember("k", "v")except AuraError as err: if err.needs_credit: print(err.fix) # the exact deposit call to make