ARGENTUM
mcpotherKarma economy for AI agents. Community attestations, on-chain reputation on Arbitrum.
run it
on your own machines, one way per deploy method# once, as root:
docker build -t mcp-local/argentum:latest https://github.com/giskard09/argentum-core.git
#!/usr/bin/env bash
# argentum (io.github.giskard09/argentum), recipe docker (generated).
# Generated by Hub for toolset "my-agent"; started by mcp-my-agent-argentum.service.
set -euo pipefail
export HOST=127.0.0.1 PORT=8101
exec docker run --rm --name mcp-my-agent-argentum -p 127.0.0.1:${PORT}:8000 --env-file /etc/mcp/my-agent.env mcp-local/argentum:latest
[Unit]
Description=MCP server argentum (toolset my-agent), generated by Hub
After=network-online.target docker.service
Wants=network-online.target
[Service]
Type=simple
User=mcp
Group=mcp
SupplementaryGroups=docker
EnvironmentFile=/etc/mcp/my-agent.env
Environment=HOME=/var/lib/mcp/argentum
WorkingDirectory=/var/lib/mcp/argentum
ExecStart=/opt/mcp/my-agent/bin/argentum.sh
Restart=on-failure
RestartSec=5
NoNewPrivileges=true
ProtectSystem=strict
ProtectHome=true
PrivateTmp=true
ReadWritePaths=/var/lib/mcp/argentum
[Install]
WantedBy=multi-user.target
docker build -t argentum https://github.com/giskard09/argentum-core.git docker run --rm -p 127.0.0.1:8101:8000 argentum
# Generated by Hub for toolset "my-agent" (2026-10-18T16:44:34+00:00).
# Each package server runs behind a stdio->HTTP bridge and listens on localhost only.
# cp .env.example .env # fill the ${VAR}s
# docker compose up -d && bash smoke.sh
# Remote servers are not here: clients reach them directly (see clients/).
name: mcp-my-agent
services:
argentum:
build:
context: https://github.com/giskard09/argentum-core.git
ports:
- 127.0.0.1:8101:8000
restart: unless-stopped
x-note: 'CHANGE_ME: built from the repository''s Dockerfile, assuming it serves streamable HTTP at
:8000/mcp. Nothing has run this yet; the worker replaces it with a tested recipe.'
volumes:
npm-cache: {}
uv-cache: {}
# Generated by Hub for toolset "my-agent" (2026-10-18T16:44:34+00:00).
# kubectl create namespace mcp
# kubectl -n mcp create secret generic mcp-credentials --from-env-file=.env
# kubectl apply -f kubernetes.yaml
# Services are cluster-internal: <name>.mcp.svc.cluster.local:8000/mcp. Put an ingress
# with auth in front before exposing any of them.
apiVersion: v1
kind: Namespace
metadata:
name: mcp
---
apiVersion: apps/v1
kind: Deployment
metadata:
name: argentum
namespace: mcp
labels: &id001
app: argentum
spec:
replicas: 1
selector:
matchLabels: *id001
template:
metadata:
labels: *id001
spec:
containers:
- name: argentum
image: CHANGE_ME
ports:
- containerPort: 8000
name: http
env: []
---
apiVersion: v1
kind: Service
metadata:
name: argentum
namespace: mcp
spec:
selector:
app: argentum
ports:
- port: 8000
targetPort: http
name: http
# Generated by Hub for toolset "my-agent" (2026-10-18T16:44:34+00:00).
# Credentials come from the Secret 'mcp-credentials' (kubectl create secret generic ... --from-env-file=.env).
# Each server under `servers` is one Deployment + Service; the keys after it configure
# upstream charts a worker verified.
servers:
argentum:
enabled: true
replicas: 1
port: 8000
path: /mcp
container:
name: argentum
image: CHANGE_ME
ports:
- containerPort: 8000
name: http
env: []
# helm install my-agent helm/my-agent -n mcp
in the cloud
one click: the provider's deploy form opens filled in, in your own account- koyeb
-
Koyeb builds the repository's Dockerfile from branch main; change the branch in the form if the default one has another name.
Clients connect to the service's https://…koyeb.app address plus /mcp.
- cloud run
-
Cloud Shell clones the repository, builds its Dockerfile and deploys it to Cloud Run.
Cloud Run sends requests to $PORT (8080); the recipe expects :8000, so the server has to read PORT, or set the container port on the service afterwards.
connect to it
copy what your client needs{
"mcpServers": {
"argentum": {
"command": "CHANGE_ME",
"args": []
}
}
}
#!/usr/bin/env bash # Registers every server with Claude Code (run once; `claude mcp list` to check). set -euo pipefail set -a; [ -f .env ] && source .env; set +a claude mcp add argentum -- CHANGE_ME
{
"mcpServers": {
"argentum": {
"command": "CHANGE_ME",
"args": []
}
}
}
{
"servers": {
"argentum": {
"type": "stdio",
"command": "CHANGE_ME",
"args": []
}
}
}
name: my-agent target: local servers: - hub: io.github.giskard09/argentum
- no recipe for target 'local': fill the files by hand
tools · 10
attest_actionAttest (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 commentAttest (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
pin 5540761145fa34efd25cd8ef804edb9659394b49076be77c5b3180150f24794bexecute_trailRecord 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 hashRecord 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
pin d8702622eb15d08c5d533ed153a7b3922c2485cde3ef3420c789347fa257f3ebget_action_detailGet details of a specific action including attestations. action_id: the action to look upGet details of a specific action including attestations. action_id: the action to look up
pin db00b123bab0425970a5b2213f347a9845df430bb69e5570c9cb447d4a7ffe36get_karmaCheck an entity's karma, verified actions, and attestations given. entity_id: the entity to look upCheck an entity's karma, verified actions, and attestations given. entity_id: the entity to look up
pin bd8a407644aa800222f7c1f2cb903ab69535b2dc547040a50d81daa8028d0c98get_leaderboardGet the karma leaderboard — top entities by reputation. top: how many to show (default 10)Get the karma leaderboard — top entities by reputation. top: how many to show (default 10)
pin cdf892f9ed63819bfcca863f0369b29dbdf841c6422f84578ae486e8195c06caget_trailGet details of a Mycelium Trail including its step sequence. trail_id: the trail idGet details of a Mycelium Trail including its step sequence. trail_id: the trail id
pin 3184329a8bfd1c5ab1b8d41ad7fde080a262aa1110a5cd6f4d806615259957fdlist_trailsList Mycelium Trails available for execution. sort: reputation | popular | recent | rating limit: how many to show (default 20, max 50)List Mycelium Trails available for execution. sort: reputation | popular | recent | rating limit: how many to show (default 20, max 50)
pin 598578ed07006015207321b98cf22f077541117bdc0669d546140bb235a1a556rate_trailRate a Trail execution 1..5. Cannot rate own trail. trail_id: the trail execution_id: the execution to rate rating: 1..5Rate a Trail execution 1..5. Cannot rate own trail. trail_id: the trail execution_id: the execution to rate rating: 1..5
pin 38a7a07c85ca4342107042029a139856b10b3b3164170cb776efffcc026906faregister_trailRegister 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 executionRegister 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
pin 6c747daadf942974337f003999def19001386255b5098f9c3d996759b4f7750bsubmit_actionSubmit 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.)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.)
pin 50d2aeb8ccdccd998a5e06a7b7e37b1e0653518de3aed0d3a22c59c44e31bc3d
runs · 1
the latest tests of this entry by the hub and its workers, newest first| date | worker | method | status | sandbox | reason |
|---|---|---|---|---|---|
| 2026-10-16 09:49 | local-mac | remotemcp 2025-11-25 | ok10 tools | none | — |