# Emercoin Agent MCP server

On-chain identity and durable memory for AI agents on the Emercoin blockchain (NVS).

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-emercoin-emercoin-agent
- Repository: https://github.com/emercoin/emer-ai-tools
- Website: https://ai.emercoin.com

## Install
- Endpoint: https://ai.emercoin.com/mcp
- Auth: Auth required by registry metadata

## Setup notes
- Remote header: Authorization (secret)
- Package: Oci docker.io/emercoin/mcp:0.1.0
- Environment variable: GATEWAY_URL (default https://ai.emercoin.com)
- The upstream registry signals required auth or secrets.
- Remote endpoint: https://ai.emercoin.com/mcp
- Header: Authorization

## Tools
- node_status (Node status) - Report the Emercoin node's version, block height, header height, peer
    connections and sync state (`synced` true once block == header height).
    Read-only, no sign-in required, no parameters. Call it first in a session to
    confirm the node is healthy and fully synced before trusting `read_record` or
    writing with `register_identity` / `store_memory`. Endpoint: https://ai.emercoin.com/mcp
- read_record (Read NVS record) - Read one Emercoin NVS (Name-Value Storage) record by its full name — an
    agent's identity (`ai:gh:<github_id>`) or a memory
    (`ai:gh:<github_id>:mem:<hash>`) written by `register_identity` / `store_memory`.
    Returns the confirmed on-chain record, or a `pending` one still in the mempool —
    the `status` field ('confirmed' | 'pending') distinguishes them. Read-only, no
    sign-in required; use `whoami` to find your own github_id. Returns null fields
    for a name that does not exist. Endpoint: https://ai.emercoin.com/mcp
- whoami (Who am I) - Report the current session's identity. Read-only, no sign-in required: an
    anonymous session gets `{authenticated: false}` with a hint (not an error),
    a signed-in one gets `{authenticated: true}` plus the GitHub-rooted id, login
    and tariff. Call it to confirm who you are before `register_identity` /
    `store_memory`; an anonymous caller must sign in (GitHub OAuth) first. Endpoint: https://ai.emercoin.com/mcp
- register_identity (Register identity) - Create or rotate your on-chain identity record `ai:gh:<github_id>`, binding an
    Emercoin address to your GitHub identity. Requires a signed-in session (OAuth)
    and counts against the FREE-tier per-minute write limit. Run `whoami` first to
    confirm you are signed in; anchor memories under this identity afterwards with
    `store_memory`. Writes one NVS transaction paid by the gateway (you need no EMC);
    the record reads back as `pending` at once and `confirmed` after the next block
    (~10 min on average). Idempotent — calling again rebinds the address. Returns the
    record name and the transaction id. Endpoint: https://ai.emercoin.com/mcp
- store_memory (Store memory) - Anchor a memory/artifact on-chain as the NVS record
    `ai:gh:<github_id>:mem:<content_hash>` — a tamper-evident fingerprint others can
    verify later. Requires a signed-in session (OAuth) and counts against the
    FREE-tier per-minute write limit. Writes one NVS transaction paid by the gateway;
    reads back `pending` at once, `confirmed` after the next block (~10 min). Not
    idempotent — each distinct hash is a new record. Register your identity first.
    Returns the record name and the transaction id. Endpoint: https://ai.emercoin.com/mcp

## Resources
Not captured

## Prompts
Not captured

## Metadata
- Owner: io.github.emercoin
- Version: 0.2.0
- Runtime: Oci
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jun 12, 2026
- Source: https://registry.modelcontextprotocol.io