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 分