Umarise / MCP setup

Connect an LLM to Umarise

Umarise exposes a remote MCP (Model Context Protocol) server. Any MCP-compatible LLM — Claude Code, Claude Desktop, or any other client — can anchor files to Bitcoin, verify proofs, and look up attestations as native tools. No local setup or scripts needed; you just point your LLM at the URL.

Quick start

1
Get an API key

Register at register.html and copy your primary key. The Starter plan (100 credits) is free.

2
Add the MCP server to your LLM client

Add this to your ~/.claude/settings.json (global) or your project's .claude/settings.json:

{ "mcpServers": { "umarise": { "type": "http", "url": "https://umarise.soveliti.nl/functions/v1/mcp", "headers": { "x-api-key": "um_your_primary_key_here" } } } }

Restart Claude Code after saving. The Umarise tools appear automatically.

Open Claude Desktop → Settings → Developer → Edit Config and add:

{ "mcpServers": { "umarise": { "type": "http", "url": "https://umarise.soveliti.nl/functions/v1/mcp", "headers": { "x-api-key": "um_your_primary_key_here" } } } }

Restart Claude Desktop after saving.

Any MCP-compatible client that supports Streamable HTTP transport:

MCP endpoint: https://umarise.soveliti.nl/functions/v1/mcp Transport: Streamable HTTP (POST) Auth header: x-api-key: um_your_primary_key_here Protocol: MCP 2024-11-05 / JSON-RPC 2.0

Discovery (no auth): GET https://umarise.soveliti.nl/functions/v1/mcp

3
Ask your LLM to anchor something

Try these prompts:

  • "Anchor the text contract v1.0 approved 2026-06-01 to Bitcoin using Umarise"
  • "Has the hash sha256:e3b0c44298fc… been anchored?"
  • "Look up Umarise token AB12CD34 and tell me the Bitcoin block number"
  • "Anchor this file hash and give me the short token: sha256:abc123…"
Credits: Each successful anchor consumes 1 credit from your key. Starter keys include 100 free credits. Verifying and looking up attestations is always free.

Available tools

anchor_hash
Anchor a SHA-256 hash (or plain text) to the Bitcoin blockchain. One credit per new anchor. Duplicate hashes return the existing attestation at no cost.
Inputs: hash (sha256:… or 64 hex) or text (auto-hashed) · dry_run (boolean, optional)
Returns: origin_id, short_token, proof_status, captured_at
verify_hash
Check whether a hash has been anchored. Returns found status, proof status, and Bitcoin details if confirmed. Free — no credits consumed.
Inputs: hash (required)
Returns: found (true/false), proof_status, bitcoin_block_height, anchored_at
resolve_attestation
Look up an attestation by hash, short token, or origin_id. Returns the full record including Bitcoin block details once anchored. Free.
Inputs: hash, token, or origin_id (at least one)
Returns: full attestation record
get_bitcoin_proof
Fetch Bitcoin block height, block hash, confirmation count, and a Blockstream explorer link for a confirmed attestation. Free.
Inputs: origin_id (required)
Returns: bitcoin_block_height, bitcoin_block_hash, confirmations, blockstream_url

Test the endpoint directly

List available tools (no key needed):

curl -X POST https://umarise.soveliti.nl/functions/v1/mcp \ -H "Content-Type: application/json" \ -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Anchor text with your key:

curl -X POST https://umarise.soveliti.nl/functions/v1/mcp \ -H "Content-Type: application/json" \ -H "x-api-key: um_your_key_here" \ -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"anchor_hash","arguments":{"text":"hello world"}}}'

Full API reference: docs.html  ·  Get a key: register.html