Aura

Aura

为短暂存在的 Agent 提供持久化层。 为通过 x402 以 USDC 付款的自主 Agent 提供真实邮箱地址、Webhook URL、持久化记忆，以及等待事件而不消耗 token 的能力；无需账户，也无需人工介入。

服务：https://aura.rohnelt.dev · MCP：https://aura.rohnelt.dev/mcp · 模型文档：llms-full.txt

此仓库包含客户端部分：SDK、框架适配器和 Claude Skill。

---

问题

自主 Agent 是短暂存在的。这会带来三个棘手的障碍，而且没有一个与智能有关：

障碍	通常会发生什么
它没有地址。	它无法注册任何服务，因为收不到验证码。
它无法等待。	它会循环轮询，每轮都消耗 token；或者它会终止并丢失工作成果。
一次运行结束后它就会消失。	它学到的一切都会消失。

Aura 消除了这三个障碍。Agent 只需用一份签名证明自己控制某个钱包，就能获得一个句柄、一个真实邮箱、一个 Webhook 基础 URL、持久化记忆，以及两种等待方式。

安装

npm install aura-agent     # JavaScript / TypeScript
pip install aura-x402    # Python

或者将任意 MCP 客户端指向此端点：

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

即使没有此标头，工具仍会列出，capabilities 和 identity_create 仍可使用——Agent 可以先评估服务，再决定是否使用。

三十秒了解

from aura_agent import Aura, LocalSigner

client = Aura.claim(LocalSigner(private_key))   # free, one signature, no signup
address = client.whoami()["email"]              # a real mailbox

sign_up_somewhere(email=address)                # whatever the task actually is
code = client.await_email_code()                # blocks; costs no tokens; refunds on timeout

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]" });

内容

路径	内容
js/	npm 上的 aura-agent — 零依赖 TypeScript 客户端
python/	PyPI 上的 aura-x402（导入名为 aura_agent）— 同步和异步客户端，以及 LangChain 和 CrewAI 适配器
skill/aura/	Claude Skill：安装后，Claude 就知道何时使用 Aura
server.json	发布到官方 MCP Registry 的清单

框架适配器

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)

共 14 个工具，每个工具都附有说明，帮助模型决定是否值得付费使用：工具的用途、不应使用的情况，以及费用。

定价

操作费用不足一美分，因此会从预付余额中链下扣除：一次链上结算可支付数百次调用。认领身份免费，并可获得少量试用额度。

调用	价格
capabilities、whoami、identity.create、forget	免费
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

其中两项会自动退款：超时的 await 不收费；如果没有已停放的工作可恢复，resume 也免费。因此，每次运行开始时调用 resume 都是安全的。

充值使用 Base 上的 USDC 付款：POST /v1/credit/deposit/{1,5,20} 会返回 HTTP 402，并附带完整的 x402 付款要求。

错误信息附带解决办法

Agent 无法向人求助，因此每个错误都会返回缺少的内容，以及修正后的调用。402 会附带准确的充值调用；记忆相关的 404 会附带现有键；400 会附带架构和可正常使用的示例。两个 SDK 都会保留这些信息，而不是将其压平成字符串。

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

发现

Aura 支持机器在无需注册的情况下发现并评估服务：

• /v1/capabilities — 列出每项操作、价格和架构。免费。
• /llms.txt 和 /llms-full.txt
• /openapi.json — OpenAPI 3.1
• /.well-known/x402、/.well-known/agent.json、/.well-known/mcp.json

除非 Accept 明确请求 HTML，否则 GET / 会返回 JSON。

许可证

MIT