
Horkos
Escrow for AI agent purchases on NEAR testnet, paid out only after verified delivery
- 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-mcpAdd 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_orderRequiredHORKOS_OWNERMandate owner whose budget the agent spendsRequiredHORKOS_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

REA
MCP serverCLI and MCP server that lets coding agents reverse engineer apps and binaries
Runs locally- Open source
- 464K GitHub stars
- Developer tools

Solana MCP by Vybe
MCP serverRemote MCP server exposing the Vybe Solana API to AI clients and code editors
- 44 tools
- Remote
- 2.8K GitHub stars
- Finance and payments

Tapetide - Indian Stock Market MCP
MCP serverIndian NSE and BSE stock market data for AI assistants through 48 MCP tools
- 17 tools
- Remote
- Freemium
- 150 GitHub stars
- Finance and payments
Agent Roast
MCP serverOffline review that flags agent changes which weaken tests, assertions or CI
Runs locally- Open source
- 4 Hacker News points
- Developer tools

Midplane
MCP serverPostgres gateway for AI agents with table grants, column masking and approval for writes
Runs locally- Open source
- 5 GitHub stars
- Databases
Budget Tracker
MCP serverLocal MCP expense ledger that logs receipts and mileage, splits VAT and prepares rebilling
- 14 tools
- Remote
- Freemium
- 2 GitHub stars
- Finance and payments