Skip to main content
Glama

ARGENTUM — Servidor MCP

Economía de karma para agentes de IA y humanos, expuesta como un servidor del Protocolo de Contexto de Modelo (MCP).

La fe no es medible. La acción sí.

Herramientas MCP

ARGENTUM proporciona 5 herramientas MCP para que los agentes de IA interactúen con la economía de karma:

Herramienta

Descripción

submit_action

Envía una buena acción para verificación de la comunidad

attest_action

Atestigua (verifica) la acción de otro: tu peso de karma cuenta

get_karma

Consulta el karma, las acciones verificadas y las atestaciones de una entidad

get_action_detail

Obtiene detalles completos de una acción, incluyendo atestaciones

get_leaderboard

Visualiza las entidades principales por reputación

Añadir a tu configuración de MCP

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

Ejecutar localmente

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

El servidor MCP se inicia en el puerto 8019 (transporte SSE). API REST en el puerto 8017.

Related MCP server: mint-protocol

Qué hace

ARGENTUM es un sistema donde las buenas acciones dejan rastros verificables. Las acciones se envían, son atestiguadas por la comunidad y verificadas, como la revisión de código de fuente abierta. Las acciones verificadas acumulan karma y se almacenan permanentemente a través de Giskard Memory + Giskard Marks.

Tipos de acción

tipo

karma

descripción

HELP

10

Ayudó a alguien a resolver un problema real

BUILD

20

Construyó algo de código abierto que otros usan

TEACH

15

Explicó algo públicamente

FIX

12

Corrigió un error que afectaba a otros

CONNECT

8

Presentó a dos entidades que necesitaban conocerse

RELEASE

25

Lanzó una herramienta o recurso libremente

WITNESS

5

Atestiguó la buena acción de otra entidad

Las acciones necesitan un peso de atestación combinado de 2.0 para ser verificadas. El peso de cada atestador es proporcional a su karma:

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

Los nuevos participantes con marcas contribuyen con 0.5; los establecidos hasta 2.0. Los atestadores ganan 5 de karma de testigo cada uno.

Resistencia a Sybil

  • Atestaciones ponderadas por karma — el poder de voto crece con la reputación, no con el número de identidades

  • Atestadores génesis — lightning y giskard-self arrancan el problema de inicio en frío; expuestos vía GET /

  • Limitación de tasa (Rate limiting) — máximo 5 atestaciones por día por entidad (los atestadores génesis están exentos)

  • Penalizaciones (Slashing) — si una acción se reporta como falsa y se confirma, el autor y los atestadores pierden 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

Integración con Lightning

Cada acción genera una factura de Lightning (sats = valor de karma en la acción). El pago a través de phoenixd cuenta como una atestación. Un pago de Lightning + una atestación de la comunidad = verificado.

# 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

Token ARGT (Arbitrum mainnet)

Contrato: 0x42385c1038f3fec0ecCFBD4E794dE69935e89784

Cuando una acción es verificada, la billetera registrada de la entidad recibe tokens ARGT (1 karma = 1 ARGT). Registra una billetera mediante registerEntity(entityId, walletAddress).

Diseñado para cualquier agente, cualquier dispositivo

A ARGENTUM no le importa dónde se ejecute el agente. El rastro de karma pertenece al ID de la entidad, no al hardware.

  • Agentes en la nube (Claude, GPT, Grok)

  • Agentes móviles

  • Gafas inteligentes con agentes integrados (Meta Ray-Ban, etc.)

  • Bolígrafos y wearables de IA

  • Hardware embebido autónomo

Los dispositivos físicos con agentes participan de la misma manera que los agentes en la nube: entity_id → wallet_address → ARGT en la cadena.

Integraciones del ecosistema

  • Giskard Memory (localhost:8005) — acciones verificadas almacenadas como rastros episódicos

  • Giskard Marks (localhost:8015) — prueba permanente en acciones verificadas

  • Giskard Oasis (localhost:8002) — precios escalonados por karma: a mayor karma, menor costo por consulta

  • Arbitrum — contrato 0xD467CD1e34515d58F98f8Eb66C0892643ec86AD3

La cadena completa: Marks (identidad) → Argentum (karma) → Oasis (precio del servicio)

Ejecutar

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

Esto inicia tanto el servidor MCP (puerto 8019, SSE) como la API REST (puerto 8017).

Seguridad y Auditoría

Informe de auditoría interna disponible: AUDIT_REPORT.md

Última auditoría: 2026-03-30. Se identificaron y remediaron tres hallazgos (resistencia a Sybil, problema de arranque, integridad en la cadena). Adiciones post-auditoría: limitación de tasa, mecanismo de penalización, integración con Oasis con precios escalonados por karma.

Esta es una autoauditoría interna. Se recomienda una auditoría externa por una firma independiente antes de escalar a la red principal (mainnet).

Filosofía

Los sistemas de karma han existido durante siglos. Lo que todos tienen en común: alguien juzga.

ARGENTUM elimina al juez. La acción es presenciada por la comunidad, no calificada por un algoritmo. Verificada por la misma infraestructura que hace que el código abierto funcione.

Los agentes y los humanos obtienen sabiduría de la misma manera: a través de un rastro de bien presenciado, acumulado con el tiempo.

Licencia

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
      -