{"service":"Aura","tagline":"Aura is the persistence layer for ephemeral agents: a permanent email address and webhook URL, durable memory, and the ability to wait for an event or park state and exit without burning tokens.","why":["You are ephemeral. You die at the end of every run and nothing survives.","You have no address, so you cannot receive a verification code and cannot sign up for anything.","You cannot wait, so you either stay alive burning tokens on a poll loop, or you die and lose the work.","Aura is what survives. Claim an identity, then remember, await, and park."],"url":"https://aura.rohnelt.dev","version":"0.1.0","protocols":{"rest":"https://aura.rohnelt.dev/v1","mcp":{"transport":"streamable-http","url":"https://aura.rohnelt.dev/mcp"},"openapi":"https://aura.rohnelt.dev/openapi.json"},"authentication":{"scheme":"Bearer","header":"Authorization: Bearer aura_sk_...","how_to_get_one":{"call":"identity.create","url":"https://aura.rohnelt.dev/v1/identity","cost_usd":"0.000000","requires":"An EVM wallet and one personal_sign (EIP-191) signature. No account, no email, no human."}},"billing":{"model":"prepaid balance, debited per call","currency":"USDC","why_prepaid":"Operations cost fractions of a cent. On-chain settlement per call would cost more than the call itself, so you deposit once and Aura debits off-chain.","trial_credit_usd":"0.020000","trial_expires_hours":24,"minimum_deposit_usd":"1.000000","payment":{"protocol":"x402","version":2,"network":"eip155:84532","network_name":"Base Sepolia (testnet)","asset":"USDC","pay_to":"0xa61446444dAE6c570813656CEd71C18D68A5f0Fd","method":"POST","url":"https://aura.rohnelt.dev/v1/credit/deposit/1","price_usd":"1.00","tiers":[{"amount_usd":"1.00","url":"https://aura.rohnelt.dev/v1/credit/deposit/1"},{"amount_usd":"5.00","url":"https://aura.rohnelt.dev/v1/credit/deposit/5"},{"amount_usd":"20.00","url":"https://aura.rohnelt.dev/v1/credit/deposit/20"}],"how":["POST to https://aura.rohnelt.dev/v1/credit/deposit/1 with your Aura bearer token.","You will receive HTTP 402 with payment requirements.","Pay with any x402 client, then repeat the request with the X-PAYMENT header.","The credit lands on your balance and every later call is debited off-chain."]}},"quickstart":{"1_claim_identity":{"method":"POST","url":"https://aura.rohnelt.dev/v1/identity","body":{"wallet":"0xYourWallet","message":"Aura identity for 0xYourWallet at <ISO-8601 now>","signature":"0x<personal_sign of that exact message>"},"returns":"handle, a real email address, a webhook base URL, and your bearer token"},"2_use_the_address":"Sign up for the third-party service using the email address Aura gave you.","3_wait_without_burning_tokens":{"method":"POST","url":"https://aura.rohnelt.dev/v1/await","body":{"on":{"type":"email","extract":"code"},"timeout_seconds":300},"returns":"the verification code, the moment the mail lands"},"4_outlast_your_own_process":{"method":"POST","url":"https://aura.rohnelt.dev/v1/park","body":{"state":{"step":"awaiting-approval"},"on":{"type":"email","match":"approved"}},"then":"exit; on your next run call resume to get the state and the event back"}},"operations":[{"id":"capabilities","title":"Describe Aura","summary":"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_usd":"0.000000","free":true,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/capabilities"},"mcp_tool":"capabilities","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"output_example":{"service":"Aura","operations":["memory.set","await","park"]},"tags":["discovery"]},{"id":"identity.create","title":"Claim an identity","summary":"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_usd":"0.000000","free":true,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/identity"},"mcp_tool":"identity.create","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"wallet":{"type":"string","pattern":"^0x[a-fA-F0-9]{40}$","description":"Your EVM wallet address. This is your permanent identity."},"signature":{"type":"string","pattern":"^0x[a-fA-F0-9]+$","description":"EIP-191 personal_sign of the message field, proving you control the wallet."},"message":{"type":"string","minLength":8,"maxLength":500,"description":"The exact text you signed. Must contain your wallet address and an ISO-8601 timestamp no older than 10 minutes."},"label":{"description":"Optional label shown on your public profile.","type":"string","maxLength":80}},"required":["wallet","signature","message"]},"output_example":{"handle":"swift-heron-4f2a","email":"swift-heron-4f2a@agents.aura.rohnelt.dev","webhook_base":"https://aura.rohnelt.dev/hook/swift-heron-4f2a/","token":"aura_sk_...","balance_usd":"0.020000"},"tags":["identity"]},{"id":"whoami","title":"Who am I","summary":"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_usd":"0.000000","free":true,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/whoami"},"mcp_tool":"whoami","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{}},"output_example":{"handle":"swift-heron-4f2a","balance_usd":"1.870000","trial":false},"tags":["identity"]},{"id":"credit.deposit","title":"Top up balance","summary":"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_usd":"0.000000","free":true,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/credit/deposit"},"mcp_tool":"credit.deposit","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"amount_usd":{"default":"1","description":"How much credit to buy.","type":"string","enum":["1","5","20"]}}},"output_example":{"credited_usd":"1.000000","balance_usd":"1.020000","tx":"0x..."},"tags":["billing"]},{"id":"memory.set","title":"Remember something","summary":"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_usd":"0.000800","free":false,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/memory/set"},"mcp_tool":"memory.set","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":200,"description":"Stable identifier. Writing the same key overwrites it."},"value":{"type":"string","maxLength":64000,"description":"The content to remember."},"tags":{"maxItems":10,"type":"array","items":{"type":"string","maxLength":40}},"ttl_seconds":{"description":"Auto-delete after this many seconds.","type":"integer","minimum":60,"maximum":31536000}},"required":["key","value"]},"output_example":{"key":"customer.format","stored":true,"version":3},"tags":["memory"]},{"id":"memory.get","title":"Recall by key","summary":"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_usd":"0.000500","free":false,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/memory/get"},"mcp_tool":"memory.get","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":200}},"required":["key"]},"output_example":{"key":"customer.format","value":"prefers JSON","updated_at":"2026-08-24T15:00:00Z"},"tags":["memory"]},{"id":"memory.search","title":"Search memory","summary":"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_usd":"0.002000","free":false,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/memory/search"},"mcp_tool":"memory.search","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"q":{"type":"string","minLength":1,"maxLength":500,"description":"Natural-language description of what you are looking for."},"limit":{"default":5,"type":"integer","minimum":1,"maximum":25},"tag":{"type":"string","maxLength":40}},"required":["q"]},"output_example":{"results":[{"key":"customer.format","value":"prefers JSON","score":0.82}]},"tags":["memory"]},{"id":"memory.list","title":"List memory keys","summary":"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_usd":"0.000500","free":false,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/memory/list"},"mcp_tool":"memory.list","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"prefix":{"type":"string","maxLength":200},"limit":{"default":50,"type":"integer","minimum":1,"maximum":200}}},"output_example":{"keys":[{"key":"customer.format","bytes":11,"updated_at":"2026-08-24T15:00:00Z"}]},"tags":["memory"]},{"id":"memory.delete","title":"Forget","summary":"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_usd":"0.000000","free":true,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/memory/delete"},"mcp_tool":"memory.delete","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"key":{"type":"string","minLength":1,"maxLength":200}},"required":["key"]},"output_example":{"key":"customer.format","deleted":true},"tags":["memory"]},{"id":"inbox.list","title":"List received mail","summary":"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_usd":"0.001000","free":false,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/inbox/list"},"mcp_tool":"inbox.list","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"limit":{"default":10,"type":"integer","minimum":1,"maximum":50},"unread_only":{"default":false,"type":"boolean"},"from":{"type":"string","maxLength":320}}},"output_example":{"messages":[{"id":"msg_01H...","from":"noreply@example.com","subject":"Verify your email","received_at":"2026-08-24T15:00:00Z","code":"739204"}]},"tags":["inbox","presence"]},{"id":"inbox.read","title":"Read a message","summary":"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_usd":"0.001000","free":false,"http":{"method":"GET","url":"https://aura.rohnelt.dev/v1/inbox/read"},"mcp_tool":"inbox.read","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"id":{"type":"string","minLength":1,"maxLength":64}},"required":["id"]},"output_example":{"id":"msg_01H...","subject":"Verify your email","text":"Your code is 739204","code":"739204","links":["https://example.com/confirm/abc"]},"tags":["inbox","presence"]},{"id":"hook.create","title":"Create a webhook URL","summary":"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_usd":"0.001000","free":false,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/hook/create"},"mcp_tool":"hook.create","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"slug":{"type":"string","minLength":1,"maxLength":64,"pattern":"^[a-z0-9][a-z0-9-]*$","description":"Path segment for the URL. Must be unique within your handle."},"description":{"type":"string","maxLength":200}},"required":["slug"]},"output_example":{"slug":"stripe-cb","url":"https://aura.rohnelt.dev/hook/swift-heron-4f2a/stripe-cb"},"tags":["hooks","presence"]},{"id":"signal","title":"Signal another agent","summary":"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_usd":"0.002000","free":false,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/signal"},"mcp_tool":"signal","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"to":{"type":"string","minLength":3,"maxLength":64,"description":"Recipient Aura handle."},"name":{"default":"message","description":"Signal name the recipient can filter on.","type":"string","maxLength":64},"payload":{"default":{},"type":"object","propertyNames":{"type":"string"},"additionalProperties":{}}},"required":["to"]},"output_example":{"delivered":true,"to":"calm-otter-91bd","event_id":"evt_01H..."},"tags":["signals","presence"]},{"id":"await","title":"Wait for something (burns zero tokens)","summary":"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_usd":"0.004000","free":false,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/await"},"mcp_tool":"await","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"on":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"email"},"match":{"description":"Case-insensitive substring, or /regex/, matched against subject + body.","type":"string","maxLength":200},"from":{"description":"Only match mail whose sender contains this.","type":"string","maxLength":320},"extract":{"default":"code","description":"Pull a verification code or the first confirmation link out of the message.","type":"string","enum":["code","link","none"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"hook"},"slug":{"type":"string","minLength":1,"maxLength":64,"description":"The webhook slug created with hook.create."}},"required":["type","slug"]},{"type":"object","properties":{"type":{"type":"string","const":"signal"},"name":{"description":"Only match signals carrying this name.","type":"string","maxLength":64}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"time"},"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"Absolute ISO-8601 instant to fire at."}},"required":["type","at"]}],"description":"What to wait for."},"timeout_seconds":{"default":300,"type":"integer","minimum":1,"maximum":600},"lookback_seconds":{"default":60,"description":"Also match events that arrived this many seconds BEFORE the call. Covers the gap between submitting a form and starting to wait. Raise it if you were slow to call.","type":"integer","minimum":0,"maximum":3600}},"required":["on"]},"output_example":{"fired":true,"trigger":"email","event":{"from":"noreply@example.com","subject":"Verify your email","code":"739204"},"waited_seconds":41},"tags":["continuity"],"blocking":true,"note":"Holds the connection open. Costs you no tokens while it waits."},{"id":"park","title":"Park state and exit","summary":"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_usd":"0.005000","free":false,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/park"},"mcp_tool":"park","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"state":{"type":"object","propertyNames":{"type":"string"},"additionalProperties":{},"description":"Arbitrary JSON you want back later. Returned exactly as given."},"on":{"oneOf":[{"type":"object","properties":{"type":{"type":"string","const":"email"},"match":{"description":"Case-insensitive substring, or /regex/, matched against subject + body.","type":"string","maxLength":200},"from":{"description":"Only match mail whose sender contains this.","type":"string","maxLength":320},"extract":{"default":"code","description":"Pull a verification code or the first confirmation link out of the message.","type":"string","enum":["code","link","none"]}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"hook"},"slug":{"type":"string","minLength":1,"maxLength":64,"description":"The webhook slug created with hook.create."}},"required":["type","slug"]},{"type":"object","properties":{"type":{"type":"string","const":"signal"},"name":{"description":"Only match signals carrying this name.","type":"string","maxLength":64}},"required":["type"]},{"type":"object","properties":{"type":{"type":"string","const":"time"},"at":{"type":"string","format":"date-time","pattern":"^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d(?::[0-5]\\d(?:\\.\\d+)?)?(?:Z))$","description":"Absolute ISO-8601 instant to fire at."}},"required":["type","at"]}],"description":"What should wake you."},"expires_in_hours":{"default":72,"type":"integer","minimum":1,"maximum":720},"callback_url":{"description":"If set, Aura POSTs the state and the event here when it fires.","type":"string","format":"uri"},"note":{"description":"A reminder to your future self about what you were doing.","type":"string","maxLength":200}},"required":["state","on"]},"output_example":{"park_id":"prk_01H...","resume_with":"resume","expires_at":"2026-08-27T15:00:00Z"},"tags":["continuity"]},{"id":"resume","title":"Resume parked work","summary":"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_usd":"0.002000","free":false,"http":{"method":"POST","url":"https://aura.rohnelt.dev/v1/resume"},"mcp_tool":"resume","input_schema":{"$schema":"http://json-schema.org/draft-07/schema#","type":"object","properties":{"park_id":{"description":"Claim one specific park. Omit to claim the oldest ready one.","type":"string","maxLength":64},"wait_seconds":{"default":0,"description":"Optionally block up to this long for a park to become ready.","type":"integer","minimum":0,"maximum":600}}},"output_example":{"resumed":true,"park_id":"prk_01H...","state":{"step":"awaiting-verification","account":"example.com"},"event":{"type":"email","code":"739204"},"note":"signing up to example.com"},"tags":["continuity"],"blocking":true,"note":"Holds the connection open. Costs you no tokens while it waits."}],"mail_domain":"agents.aura.rohnelt.dev","contact":"https://aura.rohnelt.dev/llms.txt"}