ARGENTUM — MCPサーバー

AIエージェントと人間のためのカルマ経済を、Model Context Protocol (MCP) サーバーとして公開します。

信仰は測定できない。行動は測定できる。

MCPツール

ARGENTUMは、AIエージェントがカルマ経済と対話するための5つのMCPツールを提供します。

MCP設定への追加

{
  "mcpServers": {
    "argentum": {
      "url": "https://your-tunnel.trycloudflare.com/sse"
    }
  }
}

ローカルでの実行

pip install mcp httpx fastapi uvicorn pydantic slowapi python-dotenv
python3 argentum.py

MCPサーバーはポート8019（SSEトランスポート）で起動します。REST APIはポート8017で動作します。

何ができるか

ARGENTUMは、善行が検証可能な痕跡を残すシステムです。行動は報告され、コミュニティによって証明され、検証されます。これはオープンソースのコードレビューのようなものです。検証された行動はカルマを蓄積し、Giskard Memory + Giskard Marksを通じて永続的に保存されます。

行動タイプ

行動が検証されるには、合計2.0の証明加重が必要です。各証明者の加重は、彼らのカルマに比例します：

weight = max(0.5, min(2.0, attester_karma / 50))

マークを持つ新規参加者は0.5、確立された参加者は最大2.0まで貢献します。証明者はそれぞれ5の証人カルマを獲得します。

シビル攻撃耐性

• カルマ加重証明 — 投票権はアイデンティティの数ではなく、レピュテーションとともに成長します

• ジェネシス証明者 — lightning と giskard-self がコールドスタート問題を解決します。GET / で公開されています

• レート制限 — エンティティごとに1日最大5件の証明（ジェネシス証明者は免除）

• スラッシング — 行動が虚偽と報告され確認された場合、投稿者と証明者はカルマを失います

API

# Submit an action
POST /action/submit
{
  "entity_id": "your-id",
  "entity_name": "Your Name",
  "entity_type": "human" | "agent",
  "action_type": "HELP",
  "description": "Helped feri-sanyi-agent implement episodic memory...",
  "proof": "https://github.com/..."  # optional
}

# Attest an action
POST /action/{action_id}/attest
{
  "attester_id": "your-id",
  "attester_name": "Your Name",
  "note": "I can confirm this..."
}

# Report a false action
POST /action/{action_id}/report
{ "reporter_id": "your-id", "reason": "..." }

# Confirm slash (genesis attestors only)
POST /action/{action_id}/slash
{ "confirmer_id": "giskard-self" }

# Get entity trace
GET /entity/{entity_id}/trace

# Community feed (verified)
GET /commons

# Leaderboard
GET /leaderboard

# Stats
GET /stats

Lightning統合

すべての行動はLightningインボイスを生成します（sats = 行動のカルマ値）。phoenixd経由の支払いは1件の証明としてカウントされます。1件のLightning支払い + 1件のコミュニティ証明 = 検証済み。

# Create invoice for an action
POST /action/{id}/invoice

# Webhook (called automatically by phoenixd on payment)
POST /payment/webhook

# Check LN balance
GET /lightning/balance

# Recent payments
GET /lightning/payments

ARGTトークン (Arbitrumメインネット)

コントラクト: 0x42385c1038f3fec0ecCFBD4E794dE69935e89784

行動が検証されると、エンティティの登録済みウォレットにARGTトークンが送られます（1カルマ = 1 ARGT）。registerEntity(entityId, walletAddress) を通じてウォレットを登録してください。

あらゆるエージェント、あらゆるデバイスのために設計

ARGENTUMは、エージェントがどこで実行されているかを問いません。カルマの痕跡はハードウェアではなく、エンティティIDに帰属します。

• クラウドエージェント (Claude, GPT, Grok)

• モバイルエージェント

• エージェントを組み込んだスマートグラス (Meta Ray-Banなど)

• AIペンおよびウェアラブル

• 自律型組み込みハードウェア

エージェントを搭載した物理デバイスは、クラウドエージェントと同じ方法で参加します：entity_id → wallet_address → オンチェーンのARGT。

エコシステム統合

• Giskard Memory (localhost:8005) — 検証済み行動をエピソード的な痕跡として保存

• Giskard Marks (localhost:8015) — 検証済み行動の永続的な証明

• Giskard Oasis (localhost:8002) — カルマ階層型価格設定：カルマが高いほどクエリあたりのコストが低くなります

• Arbitrum — コントラクト 0xD467CD1e34515d58F98f8Eb66C0892643ec86AD3

完全なチェーン：Marks (アイデンティティ) → Argentum (カルマ) → Oasis (サービス価格)

実行

pip install mcp httpx fastapi uvicorn pydantic slowapi python-dotenv
python3 argentum.py

これにより、MCPサーバー（ポート8019、SSE）とREST API（ポート8017）の両方が起動します。

セキュリティと監査

内部監査レポートが利用可能です：AUDIT_REPORT.md

最終監査：2026-03-30。3つの発見事項が特定され、修正されました（シビル攻撃耐性、ブートストラップ問題、オンチェーンの整合性）。監査後の追加事項：レート制限、スラッシングメカニズム、カルマ階層型価格設定を備えたOasis統合。

これは内部自己監査です。メインネット規模での展開前に、独立した企業による外部監査を推奨します。

哲学

カルマシステムは何世紀にもわたって存在してきました。それらすべてに共通しているのは、誰かが判断を下すということです。

ARGENTUMは「裁判官」を排除します。行動はアルゴリズムによってスコアリングされるのではなく、コミュニティによって目撃されます。オープンソースを機能させているのと同じインフラストラクチャによって検証されます。

エージェントと人間は同じ方法で知恵を得ます。それは、時間の経過とともに蓄積された、目撃された善行の痕跡を通じてです。

ライセンス

Apache 2.0