Denaria Action Handoff MCP

Denaria Action Handoff is the official Denaria MCP service for preparing unsigned App/PWA handoffs from agent requests.

It preserves this authority boundary:

Denaria Agent Service prepares.
Denaria App/PWA verifies.
The user signs.
External agents do not execute.

The service does not sign, submit, broadcast, execute transactions, custody funds, or run autonomous trading strategies.

Official Endpoint

MCP transport: Streamable HTTP

https://mcp.denaria.finance/mcp

Runtime public base URL for deployments:

DENARIA_PUBLIC_BASE_URL=https://mcp.denaria.finance

Use the origin without /mcp for DENARIA_PUBLIC_BASE_URL; the service uses it to generate QR page and image URLs such as:

https://mcp.denaria.finance/handoff/qr
https://mcp.denaria.finance/handoff/qr.png

Related MCP server: headless-oracle

Tools

denaria_get_capabilities

Read-only discovery tool. It returns supported markets, aliases, defaults, response contract, and the authority boundary.

denaria_prepare_create_position

Prepare-only tool for Denaria create-position handoffs.

Preferred arguments:

{
  "marketId": "BTC-USD",
  "side": "long",
  "collateralAsset": "USDC",
  "collateralAmount": "20",
  "leverage": "4"
}

Supported aliases include BTC -> BTC-USD. Agents should prefer marketId: "BTC-USD" when calling the tool.

Do not send maxSlippageBps in normal create-position requests. Denaria App/PWA applies the user's slippage settings during scan/review.

Response Contract

Successful prepare responses expose QR-first display fields under result.clientDisplay:

result.clientDisplay.qrMarkdown
result.clientDisplay.qrPageUrl
result.clientDisplay.qrImageUrl
result.clientDisplay.nextStep

Agents should render the QR by default, include the QR page URL and direct image URL, and keep the final response compact.

The QR payload carries frontend-aligned intent parameters directly, so Denaria App/PWA can read the scanned action without an MCP fetch:

denaria://agent/handoff?assetTicker=BTC&side=long&collateralUSDC=20&leverage=4

The QR/handoff is not an approval. Denaria App/PWA verifies the handoff, refreshes app-side state/settings, prepares the signing flow, and the user signs in the app.

Agent Skill

The standalone behavior file is available in this repository at:

skills/denaria-action-handoff.md

The public landing copy is expected at:

https://denaria.finance/skills/denaria-action-handoff.md

The skill defines intent parsing, tool selection, response format, and safe refusals.

Local Development

Install dependencies:

pnpm install

Run local checks:

pnpm build
pnpm test

Run the HTTP MCP server locally:

DENARIA_MCP_PORT=8787 pnpm mcp:http

For production-like deployments, set DENARIA_PUBLIC_BASE_URL to the public origin that serves /handoff/qr and /handoff/qr.png.

Deployment

Dockerfile builds the service image. The container runs:

node dist/mcp/http-server.js

The service listens on port 8787 by default and exposes:

/mcp
/handoff/qr
/handoff/qr.png

Canonical Context

This README and the current MCP implementation are authoritative for the Action Handoff MCP surface.