Aura

Aura

エフェメラルなエージェントのための永続化レイヤーです。 実在するメールアドレス、Webhook URL、永続メモリ、トークンを消費せずにイベントを待つ機能を、x402 経由で USDC を支払う自律エージェントに提供します。アカウントは不要で、人間が介在することもありません。

サービス：https://aura.rohnelt.dev · MCP：https://aura.rohnelt.dev/mcp · モデル向けドキュメント：llms-full.txt

このリポジトリにはクライアント側のものが含まれています。SDK、フレームワークアダプター、Claude Skill です。

---

問題

自律エージェントはエフェメラルです。そのため、解決が難しい3つの障壁が生じますが、どれも知能の問題ではありません。

障壁	通常起きること
アドレスがありません。	認証コードを受け取れないため、何にも登録できません。
待つことができません。	ループ内でポーリングしてターンごとにトークンを消費するか、停止して作業内容を失います。
実行の終了時に停止します。	学習したことがすべて失われます。

Aura はこの3つすべてを解消します。エージェントは1回の署名でウォレットを管理していることを証明し、ハンドル、実在するメールボックス、Webhook ベース URL、永続メモリ、そして待機する2つの方法を取得します。

インストール

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 は引き続き使用できます。つまり、エージェントは何かにコミットする前にサービスを評価できます。

30秒でわかる概要

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個のツールそれぞれについて、機能、使用すべきでない状況、料金を説明しています。

料金

操作の料金は1セント未満のため、プリペイド残高からオフチェーンで差し引かれます。オンチェーン決済1回で数百回の呼び出しをまかなえます。ID の取得は無料で、少額のトライアルクレジットが付与されます。

呼び出し	料金
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

このうち2つは料金が返金されます。タイムアウトした await は無料で、待機中の作業が準備できていない場合、resume は無料です。そのため、各実行の開始時に resume を呼び出しても問題ありません。

入金は Base 上で USDC により行います。POST /v1/credit/deposit/{1,5,20} は、x402 の決済要件一式を含む HTTP 402 を返します。

エラーには修正方法が含まれます

エージェントには問い合わせる人間がいないため、すべてのエラーは不足している情報と修正済みの呼び出しの両方を返します。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

GET / は、Accept が HTML を明示的に要求しない限り、JSON を返します。

ライセンス

MIT