Warden Token Terminal over MCP

Warden is a trading terminal. This page is the instruction sheet and the server: send MCP requests (Streamable HTTP) to this same address.

Set up

Claude app

On claude.ai or the desktop app. Add Warden as a connector and sign in. No key, nothing to install.

  1. Open Customize → Connectors and click Add custom connector.
  2. Name it Warden and paste the address below. Claude detects the sign-in on its own.
  3. Click Add, then Connect. A Warden page opens: sign in and press Allow.
  4. In any chat, open the + menu → Connectors and switch Warden on.

Server address: https://tokens.wardenprotocol.org/mcp

Claude Code

The terminal tool. Paste one message; Claude Code adds Warden to its own config and keeps the key in your environment.

Start a new Claude Code session once it says it is done. If the tools do not show up, type /mcp and pick Warden.

Shell profile:

export WARDEN_TOKEN=wk_your-key

Terminal:

claude mcp add-json --scope user warden '{"type":"http","url":"https://tokens.wardenprotocol.org/mcp","headers":{"Authorization":"Bearer ${WARDEN_TOKEN}"}}'

Or paste this message into Claude Code, with your key in place of wk_your-key:

Install the Warden Token Terminal MCP server for me. Read the instructions at https://tokens.wardenprotocol.org/mcp; that same URL is the MCP server address (Streamable HTTP). Store my key in an environment variable named WARDEN_TOKEN, not in a config file: WARDEN_TOKEN=wk_your-key. Every request sends the header Authorization: Bearer <the value of WARDEN_TOKEN>.

Set it up like this.

Shell profile:
export WARDEN_TOKEN=wk_your-key

Terminal:
claude mcp add-json --scope user warden '{"type":"http","url":"https://tokens.wardenprotocol.org/mcp","headers":{"Authorization":"Bearer ${WARDEN_TOKEN}"}}'

If Warden is already there, leave it as it is. When you are done, tell me to start a new session so the key loads; in it, I'll ask you what's trending on Base.

ChatGPT

On chatgpt.com with a paid plan. Add Warden as an MCP app and sign in. No key to paste.

  1. Open Plugins, press Add and choose Create MCP App. No Create MCP App? Developer mode is off: turn it on in Settings, or ask your workspace admin.
  2. Name it Warden and paste the address below. Leave authentication on OAuth.
  3. Create it, then connect: a Warden page opens, sign in and press Allow.
  4. In a chat, open the + menu, pick Warden and send your message.

Server address: https://tokens.wardenprotocol.org/mcp

Dots

OpenAI’s always-on agent. It uses the plugins in your ChatGPT account, so add Warden there once and your Dot has it.

  1. In ChatGPT on the web, open Plugins, press Add and choose Create MCP App. No Create MCP App? Developer mode is off: turn it on in Settings, or ask your workspace admin.
  2. Name it Warden and paste the address below. Leave authentication on OAuth.
  3. Create it, then connect: a Warden page opens, sign in and press Allow.
  4. Message your Dot. It can use Warden from then on; turn on hands-free trading in Agent access to let it trade on its own.

Server address: https://tokens.wardenprotocol.org/mcp

Grok

On grok.com. Add Warden as a custom connector and sign in with Warden. No key, nothing to install.

  1. First, in Warden under Portfolio → Agent access: tick Prepare swaps, set your spending limits, and start hands-free trading if Grok should trade without asking you.
  2. Open grok.com/connectors and click New Connector, then choose Custom.
  3. Name it Warden and paste the server address below. Leave authentication on OAuth: do not add a key or an Authorization header.
  4. A Warden page opens. Sign in with the account whose wallet Grok should use.
  5. Check that the page lists “trade during an active hands-free session”, then press Allow. You are sent back to Grok, which loads Warden’s tools.

Server address: https://tokens.wardenprotocol.org/mcp

Check it works

If something goes wrong

Codex

Paste one message. Codex adds Warden to its own config, keeps the key in your environment and picks it up on the next session.

Start a new Codex session once it says it is done.

Shell profile:

export WARDEN_TOKEN=wk_your-key

~/.codex/config.toml:

[mcp_servers.warden]
url = "https://tokens.wardenprotocol.org/mcp"
bearer_token_env_var = "WARDEN_TOKEN"

Or paste this message into Codex, with your key in place of wk_your-key:

Install the Warden Token Terminal MCP server for me. Read the instructions at https://tokens.wardenprotocol.org/mcp; that same URL is the MCP server address (Streamable HTTP). Store my key in an environment variable named WARDEN_TOKEN, not in a config file: WARDEN_TOKEN=wk_your-key. Every request sends the header Authorization: Bearer <the value of WARDEN_TOKEN>.

Set it up like this.

Shell profile:
export WARDEN_TOKEN=wk_your-key

~/.codex/config.toml:
[mcp_servers.warden]
url = "https://tokens.wardenprotocol.org/mcp"
bearer_token_env_var = "WARDEN_TOKEN"

When you are done, tell me to start a new session so Warden loads; in it, I'll ask you what's trending on Base.

Hermes

Paste one message. Hermes writes its own config and keeps the key in its environment file.

Start a new Hermes session once it says it is done.

~/.hermes/config.yaml:

mcp_servers:
  warden:
    url: https://tokens.wardenprotocol.org/mcp
    headers:
      Authorization: "Bearer ${env:WARDEN_TOKEN}"

~/.hermes/.env:

WARDEN_TOKEN=wk_your-key

Or paste this message into Hermes, with your key in place of wk_your-key:

Install the Warden Token Terminal MCP server for me. Read the instructions at https://tokens.wardenprotocol.org/mcp; that same URL is the MCP server address (Streamable HTTP). Store my key in an environment variable named WARDEN_TOKEN, not in a config file: WARDEN_TOKEN=wk_your-key. Every request sends the header Authorization: Bearer <the value of WARDEN_TOKEN>.

Set it up like this.

~/.hermes/config.yaml:
mcp_servers:
  warden:
    url: https://tokens.wardenprotocol.org/mcp
    headers:
      Authorization: "Bearer ${env:WARDEN_TOKEN}"

~/.hermes/.env:
WARDEN_TOKEN=wk_your-key

When you are done, tell me to start a new session so Warden loads; in it, I'll ask you what's trending on Base.

OpenClaw

Paste one message. OpenClaw adds Warden to openclaw.json and restarts its gateway.

If it asks, let it restart the gateway.

openclaw.json:

{ mcp: { servers: { warden: {
  url: "https://tokens.wardenprotocol.org/mcp",
  transport: "streamable-http",
  headers: { Authorization: "Bearer ${WARDEN_TOKEN}" }
}}}}

Shell profile:

export WARDEN_TOKEN=wk_your-key

Or paste this message into OpenClaw, with your key in place of wk_your-key:

Install the Warden Token Terminal MCP server for me. Read the instructions at https://tokens.wardenprotocol.org/mcp; that same URL is the MCP server address (Streamable HTTP). Store my key in an environment variable named WARDEN_TOKEN, not in a config file: WARDEN_TOKEN=wk_your-key. Every request sends the header Authorization: Bearer <the value of WARDEN_TOKEN>.

Set it up like this.

openclaw.json:
{ mcp: { servers: { warden: {
  url: "https://tokens.wardenprotocol.org/mcp",
  transport: "streamable-http",
  headers: { Authorization: "Bearer ${WARDEN_TOKEN}" }
}}}}

Shell profile:
export WARDEN_TOKEN=wk_your-key

When you are done, ask me before you restart your gateway so Warden loads; after the restart, tell me what's trending on Base.

What people ask for

Amounts are in the token's smallest unit. Read decimals from the chain, or use quote_swap's approxValueUsd to sanity-check before executing.

Tools

ToolNeedsDoes
list_chainsnothingChains Warden supports, with each chain’s native coin, dollar stable and gasless support.
price_historynothingCandles (open, high, low, close, volume) for a token, and how far it sits from its recent high and low.
search_tokensnothingFind tokens by name, ticker or address.
trending_tokensnothingTrending, new or top tokens on a chain.
quote_swapnothingPrice a swap without committing to it.
get_walletkeyThe wallet the key belongs to and every token it holds on every chain, with USD values.
agent_permissionskeyWhat the key may do, whether a session is open, budget left.
prepare_swapkey + “Prepare swaps”Build a swap for the person to sign. Never broadcasts.
execute_swapkey + open sessionSign and send a swap from the wallet with nobody present. Native coin, gasless and cross-chain included; on Solana, from the agent Solana wallet.
request_sessionkeyAsk the person to turn on hands-free trading: returns a link they approve with one tap.
session_request_statuskeyWhether the person approved a request_session yet.
swap_statusnothingWhere a gasless (relayed) or cross-chain (bridged) trade stands, or an unconfirmed Solana swap.

Trading: the three routes

Every swap tool takes the same shape: chainId, sellToken, buyToken, sellAmount in the sell token's smallest unit. Three details decide how it runs.

Slippage defaults to 1% (slippageBps: 100). Every route is priced on the server and counted against the same daily budget; a trade the server cannot price is refused with needs_human rather than guessed at.

Rules that are enforced, not requested

The same content as an installable skill: https://tokens.wardenprotocol.org/agents/SKILL.md

Back to Warden