Intented docs

CLI

npx intented: init, pay and mcp.

intented init <name>
intented pay <wallet> --to <account> --amount <amount> [--token <contract>] [--context <text> | --context-file <path>]
intented mcp

NEAR testnet only. Node 22.22 or later.

init

npx intented init my-agent

Makes the agent's key for my-agent.intented.testnet, keeps the private key in ~/.intented/testnet/ (readable by you only, never printed), and prints the public key and the link that creates the wallet. If a key is already saved for that name, it's used unchanged.

pay

npx intented pay my-agent --to intented-vendor.testnet --amount 0.001 \
  --context "HTTP 402: market data costs 0.001 wNEAR"
FlagMeaning
<wallet>the wallet, or just its name: my-agent means my-agent.intented.testnet
--tothe NEAR account to pay
--amountin whole tokens, such as 0.001
--tokenthe token contract; wrap.testnet (wNEAR) by default
--contextwhat the agent read that asked for this payment, verbatim
--context-filethe same, read from a file, for a long response body

It proposes, gets the signed verdict, and hands it to the wallet, printing each step. It exits 0 only when the payment was made.

mcp

npx intented mcp

Starts the MCP server on stdin and stdout. See From Claude Code, Cursor or Codex.

check-tx (from the repo)

Not in the package: pnpm check-tx <wallet> <tx hash> in the repo's agent/ folder checks an execute transaction from the chain alone. See Verify a payment.

Settings

VariableDefault
INTENTED_API_URLhttps://hack.furqaannabi.com, the hosted testnet API
INTENTED_WEB_URLhttps://intented-near.vercel.app, the web app, for the Create link
INTENTED_HOME~/.intented
NEAR_RPC_URLhttps://test.rpc.fastnear.com

On this page