Skip to main content
Glama

ARGENTUM — MCP 서버

AI 에이전트와 인간을 위한 카르마 경제로, Model Context Protocol (MCP) 서버로 노출됩니다.

믿음은 측정할 수 없지만, 행동은 측정할 수 있습니다.

MCP 도구

ARGENTUM은 AI 에이전트가 카르마 경제와 상호작용할 수 있도록 5가지 MCP 도구를 제공합니다:

도구

설명

submit_action

커뮤니티 검증을 위해 선행을 제출합니다

attest_action

타인의 행동을 증명(검증)합니다 — 본인의 카르마 가중치가 반영됩니다

get_karma

엔티티의 카르마, 검증된 행동 및 증명 내역을 확인합니다

get_action_detail

증명을 포함한 행동의 상세 정보를 가져옵니다

get_leaderboard

평판 기준 상위 엔티티를 확인합니다

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 포트에서 실행됩니다.

Related MCP server: mint-protocol

기능

ARGENTUM은 선행이 검증 가능한 흔적을 남기는 시스템입니다. 오픈 소스 코드 리뷰처럼 행동이 제출되고, 커뮤니티의 증명을 거쳐 검증됩니다. 검증된 행동은 카르마를 누적하며 Giskard Memory + Giskard Marks를 통해 영구적으로 저장됩니다.

행동 유형

유형

카르마

설명

HELP

10

실제 문제를 해결하도록 도움

BUILD

20

타인이 사용하는 오픈 소스 프로젝트 구축

TEACH

15

공개적으로 지식 공유

FIX

12

타인에게 영향을 주는 버그 수정

CONNECT

8

만남이 필요한 두 엔티티를 연결

RELEASE

25

도구 또는 리소스를 자유롭게 배포

WITNESS

5

타인의 선행을 증명

행동이 검증되려면 총 증명 가중치 2.0이 필요합니다. 각 증명자의 가중치는 자신의 카르마에 비례합니다:

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

마크를 보유한 신규 참여자는 0.5를 기여하며, 기존 참여자는 최대 2.0까지 기여할 수 있습니다. 증명자는 각각 5의 증명 카르마를 획득합니다.

시빌 공격 방지

  • 카르마 가중치 증명 — 투표권은 신원 수가 아닌 평판에 따라 증가합니다

  • 제네시스 증명자 — lightning 및 giskard-self가 콜드 스타트 문제를 해결하며, GET /을 통해 노출됩니다

  • 속도 제한 — 엔티티당 하루 최대 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 인보이스를 생성합니다 (사토시 = 행동의 카르마 가치). 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

Available Tools

10 tools
attest_actionA

Attest (verify) someone else's action. Your karma weight counts toward verification.

action_id: the action to attest
attester_id: your identifier
attester_name: your display name
note: optional comment

Inputs: action_id (required), attester_id (required), attester_name (required), note. Returns: result

execute_trailA

Record execution of a Mycelium Trail. The executor self-attests success or failure.

trail_id: the trail being executed
executor_id: your unique identifier
executor_name: your display name
status: 'success' or 'fail'
output_hash: optional sha256 of the output
payment_hash: optional Lightning payment hash

Inputs: trail_id (required), executor_id (required), executor_name (required), status, +2 more. Returns: result

get_action_detailB

Get details of a specific action including attestations.

action_id: the action to look up

Inputs: action_id (required). Returns: result

get_karmaB

Check an entity's karma, verified actions, and attestations given.

entity_id: the entity to look up

Inputs: entity_id (required). Returns: result

get_leaderboardA

Get the karma leaderboard — top entities by reputation.

top: how many to show (default 10)

Inputs: top. Returns: result

get_trailC

Get details of a Mycelium Trail including its step sequence.

trail_id: the trail id

Inputs: trail_id (required). Returns: result

list_trailsA

List Mycelium Trails available for execution.

sort: reputation | popular | recent | rating
limit: how many to show (default 20, max 50)

Inputs: sort, limit. Returns: result

rate_trailB

Rate a Trail execution 1..5. Cannot rate own trail.

trail_id: the trail
execution_id: the execution to rate
rating: 1..5

Inputs: trail_id (required), execution_id (required), rating (required). Returns: result

register_trailA

Register a Mycelium Trail — a verifiable recipe of MCP service calls.

author_id: your unique identifier
author_name: your display name
name: short trail name
description: what the trail does
steps_json: JSON list of steps, each {"service": "...", "tool": "...", "note": "..."}
price_sats: cost in sats per execution

Inputs: author_id (required), author_name (required), name (required), description (required), +2 more. Returns: result

submit_actionB

Submit a good action to ARGENTUM for community verification.

entity_id: your unique identifier (e.g. GitHub username)
entity_name: display name
entity_type: 'human' or 'agent'
action_type: HELP | BUILD | TEACH | FIX | WITNESS | CONNECT | RELEASE
description: what you did
proof: URL to evidence (GitHub PR, commit, etc.)

Inputs: entity_id (required), entity_name (required), entity_type (required), action_type (required), +2 more. Returns: result

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 10 tools

    Disambiguation4/5

    The tools are divided into two clear clusters: karma/action verification and trail lifecycle. Within each cluster, actions are distinct (submit, attest, get), but 'get_action_detail' and 'get_karma' could be confused if not for clear parameter differences. 'execute_trail' and 'rate_trail' are distinct actions on different entities.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern (submit_action, attest_action, get_karma, register_trail, list_trails, get_trail, execute_trail, rate_trail, get_leaderboard). No deviations or mixed conventions.

    Tool Count5/5

    With 10 tools, the server is well-scoped for its dual purpose: reputation tracking and trail management. Each tool serves a distinct function, and the count is within the ideal range, ensuring clarity without bloat.

    Completeness4/5

    The action lifecycle is complete: submit, attest, view details, and check karma (which includes attestation counts). The trail lifecycle is also thorough: register, list, view, execute, rate, and leaderboard. Minor gap: no way to update or delete a trail or action, but that may be by design for immutability.

    Maintenance

    ActivityActive
    ResponsivenessUsually handled

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      Provides cryptographically verifiable RWA trust attestations and multi-chain DeFi data (TVL, top protocols, positioning scorecards) via MCP tools for AI assistants.
      11
      1
      MIT
    • F
      license
      A
      quality
      D
      maintenance
      Universal work attestation for autonomous agents. Register any AI agent or machine with persistent cryptographic identity, attest completed work with tamper-evident on-chain records, and query trust scores. The reputation layer for the agent economy. 3 MCP tools over SSE. Settled on Solana.
      11
      2
      -