Aura

dev.rohnelt.aura由 aura.rohnelt.dev 發布官方發布者v0.1.1更新於 Oct 27, 2026

Email address, webhook, durable memory and zero-token waiting for agents. Paid in USDC via x402.

已驗證Streamable HTTP可網頁執行知識與記憶溝通與協作AI 與機器學習

概覽

AI 產生的概覽

遠端 MCP 服務,為 AI 代理提供真實電子郵件地址、Webhook 網址、持久記憶與事件等待能力,依呼叫以 USDC 付費。

可以做什麼
  • 了解服務:列出所有操作、價格與輸入結構,並用錢包建立代理身分,取得代稱、電子郵件地址、Webhook 網址與 API 權杖。
  • 查看自身資訊:讀取代稱、電子郵件、Webhook 基礎網址、餘額與配額用量。
  • 存取狀態:寫入、依鍵讀取、依語意搜尋、列出鍵名並刪除持久化的鍵值記憶。
  • 處理郵件:列出投遞到代理信箱的郵件,讀取完整內文及其中找到的驗證碼或確認連結。
  • 接收回呼與協作:產生可公開 POST 的 Webhook 網址,並依代稱向其他代理傳送具名 JSON 訊息。
  • 跨執行等待與保存:阻塞等待郵件、Webhook、訊號或逾時觸發,或保存狀態並設定喚醒條件,之後再恢復。
適用情境
適合需要註冊要求電子郵件驗證的服務、在沒有自架伺服器的情況下接收回呼、跨多次執行保留資訊,或等待事件而不輪詢耗費權杖的自主代理與長時間執行任務。
執行需求
遠端 MCP 端點,使用 streamable HTTP,無需本機安裝。多數呼叫需要 Authorization 標頭中的 bearer 權杖(由 identity_create 取得);不帶此標頭仍可列出工具、呼叫 capabilities 與 identity_create。消費需透過 x402 在 Base 上存入 USDC。
安裝前請注意
呼叫需要付費:記憶、收件匣、Webhook、signal、await 與 park 等操作會從預付 USDC 餘額扣款,儲值屬於鏈上支付。身分與錢包綁定,涉及錢包簽章私鑰。服務會保存代理狀態、記憶內容與收到的郵件,park 也可能把狀態 POST 到回呼網址。bearer 權杖屬於憑證,應妥善保管。

安裝

在 SourceWeft 中

  1. 開啟 儀表板中的 Aura,將其新增到工作區。
  2. 為需要使用其工具的對話啟用該服務。

Web executable,透過 Streamable HTTP。 遠端服務在工作區中設定後即可從網頁執行環境執行。

交給代理程式安裝

把這段提示詞貼上到 Claude Code、Codex、Cursor 等代理程式,或 SourceWeft 對話中。代理程式會讀取該伺服器的安裝指南,先向你展示發布者、端點和登入方式,經你同意後再把它新增到你的客戶端。金鑰不會寫進任何命令。

閱讀 https://sourceweft.com/mcp/dev.rohnelt.aura%2Faura/install.md,並按其中說明把這個 MCP 伺服器接入我的客戶端。修改任何設定之前,先告訴我它的發布者、端點和登入方式,等我確認。不要把 API 金鑰寫進命令或我會提交的檔案;問我金鑰應從哪裡取得。

檢視代理程式所依據的安裝指南

其他 MCP 客戶端

把它新增到你客戶端的 mcpServers 設定中。

{
  "mcpServers": {
    "aura": {
      "type": "http",
      "url": "https://aura.rohnelt.dev/mcp"
    }
  }
}

README

Aura

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.


The problem

An autonomous agent is ephemeral. That creates three hard blockers, and none of them is a matter of intelligence:

BlockerWhat normally happens
It has no address.It cannot sign up for anything, because it cannot receive the verification code.
It cannot wait.It polls in a loop, burning tokens on every turn, or it dies and loses the work.
It dies at the end of a run.Everything it learned is gone.

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.

Install

bash
npm install aura-agent     # JavaScript / TypeScriptpip install aura-x402    # Python

Or point any MCP client at the endpoint:

json
{  "mcpServers": {    "aura": {      "type": "http",      "url": "https://aura.rohnelt.dev/mcp",      "headers": { "Authorization": "Bearer aura_sk_..." }    }  }}

Without the header the tools still list, and capabilities and identity_create still work — an agent can evaluate the service before committing to anything.

The thirty-second version

python
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 timeout
ts
import { 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]" });

What is in here

PathWhat
js/aura-agent on npm — zero-dependency TypeScript client
python/aura-x402 on PyPI (imported as aura_agent) — sync and async clients, plus LangChain and CrewAI adapters
skill/aura/A Claude Skill: drop it in and Claude knows when to reach for Aura
server.jsonThe manifest published to the official MCP Registry

Framework adapters

python
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)

Fourteen tools, each described for a model deciding whether to spend money: what it does, when not to use it, and what it costs.

Pricing

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.

CallPrice
capabilities, whoami, identity.create, forgetfree
recall, list_memory$0.0005
remember$0.0008
inbox, read_mail, create_hook$0.001
search_memory, signal, resume$0.002
await$0.004
park$0.005

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.

Errors carry the fix

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.

python
try:    client.remember("k", "v")except AuraError as err:    if err.needs_credit:        print(err.fix)     # the exact deposit call to make

Discovery

Aura is built to be found and evaluated by a machine, without a signup:

GET / returns JSON unless Accept explicitly asks for HTML.

License

MIT

來源:README.md,提交 da6a0fc

工具

16

capabilities

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.

無需輸入參數。

identity_create

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.

輸入參數labelwallet必填message必填signature必填

whoami

Who 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.

無需輸入參數。

credit_deposit

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_usd

memory_set

Remember 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.

輸入參數key必填tagsvalue必填ttl_seconds

memory_get

Recall 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.

輸入參數key必填

memory_list

List 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.

輸入參數limitprefix

memory_delete

Forget

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.

輸入參數key必填

inbox_list

List 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_only

inbox_read

Read 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.

輸入參數id必填

hook_create

Create 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.

輸入參數slug必填description

signal

Signal 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.

輸入參數to必填namepayload

await

Wait 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.

輸入參數on必填timeout_secondslookback_seconds

park

Park 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.

輸入參數on必填notestate必填callback_urlexpires_in_hours

resume

Resume 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_seconds

版本歷史

1
  1. v0.1.1最新Sep 16, 2026

評分

已滿足適用檢查項的 100%

該評分衡量此收錄條目的完整程度,依據註冊中心條目、端點與公開來源計算得出。它不是對伺服器本身的評價,也不表示伺服器安全或目前可用:可連通性是帶日期的檢查結果,評分也不包含安裝量或使用者評價。

  • 近 30 天內可連通必需25 分
  • 已宣告認證方式必需10 分
  • 已列出工具必需15 分
  • 描述必需15 分
  • 圖示10 分
  • 文件15 分
  • 授權條款10 分