MCP quickstart — Claude Desktop

Five minutes from install to "what's BTC trading at?" in Claude Desktop. No build step — Claude Desktop runs the server straight from npm with npx.

Private beta. @tria-sdk/api-trading-mcp is on npm but access-restricted during beta. Ask your Tria contact to grant your npm user access (or for a read token), then authenticate once — npm login --scope=@tria-sdk or add //registry.npmjs.org/:_authToken=… to your ~/.npmrc. The npx command below is unchanged once the package goes public.

1. Get an SDK env

The server signs orders with an HL agent wallet and/or a Decibel delegate keypair — not your main wallet. Mint them from Settings → API Keys or npx tria-trade-provision (see Credentials) and keep them somewhere safe:

# ~/.config/tria/sdk.env
export TRIA_TRADE_NETWORK=mainnet
export TRIA_TRADE_HL_AGENT_KEY=0x...
export TRIA_TRADE_HL_ACCOUNT_ADDRESS=0x...
# Optional — only if you also want Decibel:
export TRIA_TRADE_DECIBEL_DELEGATE_KEY=0x...
export TRIA_TRADE_DECIBEL_APTOS_OWNER_ADDRESS=0x...
export TRIA_TRADE_DECIBEL_NODE_API_KEY=...

2. Wire it into Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows). Create it if it doesn't exist:

{
  "mcpServers": {
    "tria-trade": {
      "command": "npx",
      "args": ["-y", "@tria-sdk/api-trading-mcp"],
      "env": {
        "TRIA_TRADE_NETWORK": "mainnet",
        "TRIA_TRADE_HL_AGENT_KEY": "0x...",
        "TRIA_TRADE_HL_ACCOUNT_ADDRESS": "0x..."
      }
    }
  }
}

npx -y @tria-sdk/api-trading-mcp downloads and runs the latest server on demand — no clone, no build, no paths to manage. The credentials live in the env block (or are inherited from the shell) and never reach the LLM.

3. Restart + verify

Restart Claude Desktop completely (Quit, not just close the window). Click the 🔌 icon — you should see tria-trade with 25 tools. Then ask:

What's the current BTC ticker on Hyperliquid?

If Claude responds with live mark/mid/oracle prices, you're set.

Other clients

{
  "mcp.servers": {
    "tria-trade": {
      "command": "npx",
      "args": ["-y", "@tria-sdk/api-trading-mcp"],
      "env": { "TRIA_TRADE_HL_AGENT_KEY": "0x...", "...": "..." }
    }
  }
}

Troubleshooting

  • Not appearing in Claude Desktop — verify the config path, valid JSON (no trailing commas), and a full restart. Run the server manually to check it starts: npx -y @tria-sdk/api-trading-mcp with the env vars set — it should wait silently on stdin.
  • npm error 404 / E401 on npx — you don't have npm access yet (private beta). Authenticate per the note above, or confirm your token has read access to the @tria-sdk scope.
  • "at least one venue must be configured" — set a complete venue: HL needs TRIA_TRADE_HL_AGENT_KEY + TRIA_TRADE_HL_ACCOUNT_ADDRESS; Decibel needs the delegate key + owner address + node API key.
  • "User or API Wallet 0x… does not exist" (HL) — the agent isn't approved or expired. Mint a fresh one from Settings → API Keys.
  • Debug logging — set DEBUG=mcp:* in the env block; logs go to stderr (Claude Desktop's mcp-server-tria-trade.log).
  • Pin a version — npx resolves the latest release; to pin, use @tria-sdk/api-trading-mcp@8.0.4-beta in args.

Was this page helpful?