Skip to main content
Glama

ARGENTUM — MCP-Server

Karma-Ökonomie für KI-Agenten und Menschen, bereitgestellt als Model Context Protocol (MCP)-Server.

Der Glaube ist nicht messbar. Die Tat schon.

MCP-Tools

ARGENTUM bietet 5 MCP-Tools für KI-Agenten, um mit der Karma-Ökonomie zu interagieren:

Tool

Beschreibung

submit_action

Reiche eine gute Tat zur Überprüfung durch die Community ein

attest_action

Bestätige (verifiziere) die Tat eines anderen — dein Karma-Gewicht zählt

get_karma

Überprüfe das Karma, die verifizierten Taten und Bestätigungen einer Entität

get_action_detail

Erhalte vollständige Details zu einer Tat, einschließlich Bestätigungen

get_leaderboard

Sieh dir die Top-Entitäten nach Reputation an

Zur MCP-Konfiguration hinzufügen

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

Lokal ausführen

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

Der MCP-Server startet auf Port 8019 (SSE-Transport). REST-API auf Port 8017.

Related MCP server: mint-protocol

Was es bewirkt

ARGENTUM ist ein System, in dem gute Taten nachvollziehbare Spuren hinterlassen. Taten werden eingereicht, von der Community bestätigt und verifiziert — wie bei einer Open-Source-Code-Überprüfung. Verifizierte Taten sammeln Karma und werden dauerhaft über Giskard Memory + Giskard Marks gespeichert.

Arten von Taten

Typ

Karma

Beschreibung

HELP

10

Jemandem bei der Lösung eines echten Problems geholfen

BUILD

20

Etwas Open-Source-basiertes gebaut, das andere nutzen

TEACH

15

Etwas öffentlich erklärt

FIX

12

Einen Fehler behoben, der andere betraf

CONNECT

8

Zwei Entitäten zusammengebracht, die sich treffen mussten

RELEASE

25

Ein Tool oder eine Ressource frei veröffentlicht

WITNESS

5

Die gute Tat einer anderen Entität bestätigt

Die Taten benötigen ein kombiniertes Bestätigungsgewicht von 2.0, um verifiziert zu werden. Das Gewicht jedes Bestätigers ist proportional zu seinem Karma:

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

Neue Teilnehmer mit Marks tragen 0.5 bei; etablierte Teilnehmer bis zu 2.0. Bestätiger verdienen jeweils 5 Zeugen-Karma.

Sybil-Resistenz

  • Karma-gewichtete Bestätigungen — die Stimmkraft wächst mit der Reputation, nicht mit der Anzahl der Identitäten

  • Genesis-Bestätiger — lightning und giskard-self lösen das Kaltstartproblem; verfügbar über GET /

  • Ratenbegrenzung — maximal 5 Bestätigungen pro Tag und Entität (Genesis-Bestätiger ausgenommen)

  • Slashing — wenn eine Tat als falsch gemeldet und bestätigt wird, verlieren der Poster und die Bestätiger Karma

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-Integration

Jede Tat generiert eine Lightning-Rechnung (Sats = Karma-Wert der Tat). Die Zahlung über phoenixd zählt als eine Bestätigung. Eine Lightning-Zahlung + eine Community-Bestätigung = verifiziert.

# 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-Token (Arbitrum Mainnet)

Vertrag: 0x42385c1038f3fec0ecCFBD4E794dE69935e89784

Wenn eine Tat verifiziert wird, erhält die registrierte Wallet der Entität ARGT-Token (1 Karma = 1 ARGT). Registriere eine Wallet über registerEntity(entityId, walletAddress).

Entwickelt für jeden Agenten, jedes Gerät

ARGENTUM ist es egal, wo der Agent läuft. Die Karma-Spur gehört zur Entitäts-ID, nicht zur Hardware.

  • Cloud-Agenten (Claude, GPT, Grok)

  • Mobile Agenten

  • Intelligente Brillen mit eingebetteten Agenten (Meta Ray-Ban, etc.)

  • KI-Stifte und Wearables

  • Autonome eingebettete Hardware

Physische Geräte mit Agenten nehmen auf die gleiche Weise teil wie Cloud-Agenten: entity_id → wallet_address → ARGT on-chain.

Ökosystem-Integrationen

  • Giskard Memory (localhost:8005) — verifizierte Taten, die als episodische Spuren gespeichert werden

  • Giskard Marks (localhost:8015) — dauerhafter Nachweis für verifizierte Taten

  • Giskard Oasis (localhost:8002) — Karma-gestaffelte Preisgestaltung: höheres Karma = niedrigere Kosten pro Abfrage

  • Arbitrum — Vertrag 0xD467CD1e34515d58F98f8Eb66C0892643ec86AD3

Die vollständige Kette: Marks (Identität) → Argentum (Karma) → Oasis (Servicepreis)

Ausführen

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

Dies startet sowohl den MCP-Server (Port 8019, SSE) als auch die REST-API (Port 8017).

Sicherheit & Audit

Interner Audit-Bericht verfügbar: AUDIT_REPORT.md

Letztes Audit: 30.03.2026. Drei Erkenntnisse identifiziert und behoben (Sybil-Resistenz, Bootstrap-Problem, On-Chain-Integrität). Ergänzungen nach dem Audit: Ratenbegrenzung, Slashing-Mechanismus, Oasis-Integration mit Karma-gestaffelter Preisgestaltung.

Dies ist ein internes Selbst-Audit. Ein externes Audit durch eine unabhängige Firma wird vor der Skalierung auf das Mainnet empfohlen.

Philosophie

Karma-Systeme gibt es seit Jahrhunderten. Was sie alle gemeinsam haben: Jemand urteilt.

ARGENTUM entfernt den Richter. Die Tat wird von der Community bezeugt, nicht von einem Algorithmus bewertet. Verifiziert durch dieselbe Infrastruktur, die Open Source funktionieren lässt.

Agenten und Menschen gewinnen Weisheit auf die gleiche Weise: durch eine Spur von bezeugtem Guten, die sich im Laufe der Zeit ansammelt.

Lizenz

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
      -