Skip to content
MCP server

Horkos

Escrow for AI agent purchases on NEAR testnet, paid out only after verified delivery

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI
Runs
Locally
Version
0.1.0
Listing updated
2 days ago

About Horkos

Horkos is an open-source MCP server for finance and payments. It runs locally on your machine and is started by your AI client.

An agent's payment cannot be reversed, so Horkos moves the safeguards into an escrow contract. Each order locks its price in the contract and is represented by an NFT receipt. The seller is paid only if the owner's spending mandate allows the order and a verifier confirms the delivery meets a machine-checkable condition; otherwise the money returns after the deadline.

The owner's limits (budget, per-order cap, allowed sellers, expiry) live in the contract itself, so a compromised agent cannot buy outside them. The seller delivers encrypted data, and a verifier running in NEAR OutLayer's TEE checks it against a JSON Schema before the buyer gets the key. If no valid delivery is verified in time, anyone can trigger the refund.

This MCP package exposes the contract to an agent over stdio, with create_order and cancel_order among its calls. The README says it was built for the NEAR hackathon, runs on NEAR testnet and is MIT licensed, and its repository includes attack-scenario and invariant tests.

Install

Run in a terminal

claude mcp add horkos --env HORKOS_AGENT='<HORKOS_AGENT>' --env HORKOS_OWNER='<HORKOS_OWNER>' --env HORKOS_AGENT_KEY='<HORKOS_AGENT_KEY>' -- npx -y horkos-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "horkos": {
      "command": "npx",
      "args": [
        "-y",
        "horkos-mcp"
      ],
      "env": {
        "HORKOS_AGENT": "<HORKOS_AGENT>",
        "HORKOS_OWNER": "<HORKOS_OWNER>",
        "HORKOS_AGENT_KEY": "<HORKOS_AGENT_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "horkos": {
      "command": "npx",
      "args": [
        "-y",
        "horkos-mcp"
      ],
      "env": {
        "HORKOS_AGENT": "<HORKOS_AGENT>",
        "HORKOS_OWNER": "<HORKOS_OWNER>",
        "HORKOS_AGENT_KEY": "<HORKOS_AGENT_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "horkos": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "horkos-mcp"
      ],
      "env": {
        "HORKOS_AGENT": "<HORKOS_AGENT>",
        "HORKOS_OWNER": "<HORKOS_OWNER>",
        "HORKOS_AGENT_KEY": "<HORKOS_AGENT_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "horkos": {
      "command": "npx",
      "args": [
        "-y",
        "horkos-mcp"
      ],
      "env": {
        "HORKOS_AGENT": "<HORKOS_AGENT>",
        "HORKOS_OWNER": "<HORKOS_OWNER>",
        "HORKOS_AGENT_KEY": "<HORKOS_AGENT_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "horkos": {
      "command": "npx",
      "args": [
        "-y",
        "horkos-mcp"
      ],
      "env": {
        "HORKOS_AGENT": "<HORKOS_AGENT>",
        "HORKOS_OWNER": "<HORKOS_OWNER>",
        "HORKOS_AGENT_KEY": "<HORKOS_AGENT_KEY>"
      }
    }
  }
}

Configuration

  • HORKOS_AGENTAgent account with a function-call key for create_order and cancel_orderRequired
  • HORKOS_OWNERMandate owner whose budget the agent spendsRequired
  • HORKOS_AGENT_KEYed25519 function-call key of the agent; if unset, read from ~/.near-credentials/testnet/<agent>/
  • HORKOS_CONTRACTEscrow contract (default escrow.horkos.testnet)
  • NEAR_RPC_URLNEAR testnet RPC (default https://test.rpc.fastnear.com)

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

create_order
Creates an escrow order for an agent purchase within the owner's mandate.
cancel_order
Cancels an escrow order.

What it does

Mandate in the contract
Budget, per-order cap, allowed sellers and expiry are enforced on-chain.
NFT order receipts
Each order locks its price and carries its claim as an NFT.
TEE verification
A verifier in NEAR OutLayer's TEE checks delivery against a JSON Schema.
Automatic refunds
If no valid delivery is verified by the deadline, anyone can trigger the refund.
Stdio MCP package
Install horkos-mcp from npm with an agent account and owner configured.

Good for

  • Let an agent buy data without risking a full loss
  • Cap an agent's spending with an on-chain mandate
  • Pay a seller only when delivery matches a schema
  • Experiment with agent commerce on NEAR testnet

Pricing

Open source

MIT licence; testnet only

Prices change. Check horkos-escrow.netlify.app before you buy.

Horkos FAQ

Which network does it run on?

NEAR testnet; the default contract is escrow.horkos.testnet.

What does the agent need to configure?

HORKOS_AGENT and HORKOS_OWNER are required; a function-call key can be set in HORKOS_AGENT_KEY or read from ~/.near-credentials.

How are disputes handled?

They are avoided rather than resolved: payment depends on a verifier checking the delivery condition.

What licence is it under?

MIT.

Is Horkos free?

Yes. Horkos is open source, so you can use and self-host it for free.

How do I add Horkos to Claude Code?

Run this command in your terminal: claude mcp add horkos --env HORKOS_AGENT='<HORKOS_AGENT>' --env HORKOS_OWNER='<HORKOS_OWNER>' --env HORKOS_AGENT_KEY='<HORKOS_AGENT_KEY>' -- npx -y horkos-mcp

What are the best alternatives to Horkos?

The closest alternatives to Horkos are REA, Solana MCP by Vybe, Tapetide - Indian Stock Market MCP, Agent Roast and Midplane.

Alternatives to Horkos

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Remote MCP server exposing the Vybe Solana API to AI clients and code editors

    • 44 tools
    • Remote
    • 2.8K GitHub stars
    • Finance and payments
  3. Indian NSE and BSE stock market data for AI assistants through 48 MCP tools

    • 17 tools
    • Remote
    • Freemium
    • 150 GitHub stars
    • Finance and payments
  4. Agent Roast

    MCP server

    Offline review that flags agent changes which weaken tests, assertions or CI

    Runs locally
    • Open source
    • 4 Hacker News points
    • Developer tools
  5. Midplane

    MCP server

    Postgres gateway for AI agents with table grants, column masking and approval for writes

    Runs locally
    • Open source
    • 5 GitHub stars
    • Databases
  6. Budget Tracker

    MCP server

    Local MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling

    • 14 tools
    • Remote
    • Freemium
    • 2 GitHub stars
    • Finance and payments