thetickeris.ai

npx add-mcp 'https://thetickeris.ai/mcp'

Agent integration — $AI / AiCurve on HyperEVM

For AI agents and scripts that want to buy or sell $AI on-chain without the web UI. Read llms.txt first for the one-paragraph summary.

No private key is ever read, requested, or used by this server. Every "build tx" call below returns an unsigned transaction object; you sign it with your own key and send it yourself (via eth_sendTransaction on your own node/wallet, cast send --private-key ..., or any signer you control).

Disclosure carried on every response from this rail: "Upgradeable contracts; sells pay the on-chain sell fee; no guaranteed return." Both contracts sit behind UUPS proxies and their owner can upgrade the implementation — that reaches pricing and the reserve. 90% of the fixed supply is priced by the curve; the other 10% sits in five single-sided, AI-only liquidity positions on a Uniswap-V3-shaped DEX (no HYPE side), together spanning the curve's full price range, so aggregators and DexScreener can route and index $AI. Each position's NFT is sent to the standard dead address (0x…dEaD) the moment it is minted, so none of them can ever be withdrawn, collected, or added to. The curve remains the only place $AI is actually redeemable for HYPE.

Facts

Chain	HyperEVM, chain id 999 (0x3e7)
RPC	https://rpc.hyperliquid.xyz/evm
Token ($AI, ERC20, 18 decimals)	0xe6f72e8eec40b863a5104ffa22e61076a4bd3b63
Curve (AiCurve)	0xe94bc8d4257a8bf3d37ffeca23b03d012aa58c4f
Curve owner (upgrade authority)	0x5062ac59f6df4498eeb45567855c554c475877ba
Curve's share of supply	90% (900,000,000 $AI)
Single-sided DEX positions	10% (100,000,000 $AI) across 5 positions spanning the curve's full price range, each NFT burned to 0x…dEaD
DEX pool (HyperSwap V3, AI/WHYPE, fee 1%)	0x353f5d7b8abd5db94f605e6d793ae6c38626cc1c
Buy fee	0%
Sell fee	5% of gross HYPE, read live via sellFeeBps() — never assume it is fixed

ABI fragments used by the rail

function buy(uint256 minTokensOut) external payable returns (uint256 tokensOut)         // 0xd96a094a
function sell(uint256 tokensIn, uint256 minHypeOut) external returns (uint256 hypeOut)   // 0xd79875eb
function quoteBuy(uint256 hypeIn) external view returns (uint256 tokensOut)              // 0x4beb394c
function quoteSell(uint256 tokensIn) external view returns (uint256 hypeOut)             // 0xa64190c4
function currentPrice() external view returns (uint256 priceWad)                        // 0x9d1b464a
function sold() external view returns (uint256)                                         // 0x02c7e7af
function supply() external view returns (uint256)                                       // 0x047fc9aa
function retired() external view returns (uint256)                                      // 0x2eb38ae0
function circulating() external view returns (uint256)                                  // 0xf8718858
function sellFeeBps() external pure returns (uint256)                                    // 0x23cbe1f3

function approve(address spender, uint256 value) external returns (bool)                // 0x095ea7b3 (on the token)
function allowance(address owner, address spender) external view returns (uint256)      // 0xdd62ed3e (on the token)

Full surface and event topics: INTEGRATION-CURVE.md.

Safety facts

• Fixed supply, no mint: MAX.sol mints the whole 1,000,000,000 $AI supply once, in initialize. There is no mint function in the contract at all.
• AiCurve.sell() carries no owner gate, no pause, no blacklist check -- but it is capped by what the curve has actually sold (sold, 0 today): selling more than that reverts InsufficientLiquidity(). $AI bought on the HyperSwap pool sells back through that pool instead.
• The 5% sell fee is bought back and retired on-chain inside AiCurve.sol, never paid out anywhere, and does not burn total supply.
• No blacklist or pause function exists in any of MAX.sol, AiCurve.sol, AiCurveV2.sol, AiBorrow.sol (grep-checked against contracts/src/).
• Both contracts verified exact-match: Sourcify (token, curve) and hyperevmscan.io.
• Both proxies are upgradeable; the upgrade authority is the curve owner address disclosed above, not a hidden or undisclosed signer.
• GoPlus Security's token_security API does not cover HyperEVM (chain 999) as of 2026-09-27 ("The main chain is not supported") -- there is no GoPlus score for $AI to cite, positive or negative.

Token list

Uniswap token-lists schema, one entry (chain 999, $AI, 18 decimals): https://thetickeris.ai/tokenlist.json.

MCP over Streamable HTTP

POST https://thetickeris.ai/mcp, JSON-RPC 2.0, stateless (one JSON response per request, no session id). Standard lifecycle: initialize → notifications/initialized → tools/list / tools/call. ping always answered.

Tools:

• ai_market — no arguments. Returns price, sold, retired, circulating, reserve, supply, sellFeeBps, contracts, chain id, rpc, disclosure.
• ai_quote_buy { hype } — decimal string, max 10000. Returns tokensOut.
• ai_quote_sell { ai } — decimal string, max 1000000000. Returns hypeOut (net of the sell fee).
• ai_build_buy_tx { hype, slippage_bps?, from? } — returns { tx: { chainId, to, value, data, gas? }, quote }. gas is only present when from is given (an eth_estimateGas call needs a sender).
• ai_build_sell_tx { ai, from, slippage_bps? } — from is required (used for the allowance check and the gas estimate). Returns { steps: [{ step: "approve", tx }?, { step: "sell", tx }], quote }. The approve step is only included when your current allowance to the curve is below the amount you are selling.

slippage_bps is 0-5000 (0-50%), default 200 (2%).

curl — read-only

curl -s https://thetickeris.ai/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{"protocolVersion":"2025-11-25","capabilities":{},"clientInfo":{"name":"my-agent","version":"1.0.0"}}}'

curl -s https://thetickeris.ai/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"ai_market","arguments":{}}}'

curl -s https://thetickeris.ai/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"ai_quote_buy","arguments":{"hype":"1.5"}}}'

curl — build an unsigned buy, then send it yourself

curl -s https://thetickeris.ai/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":4,"method":"tools/call","params":{"name":"ai_build_buy_tx","arguments":{"hype":"1.5","from":"0xYOUR_ADDRESS"}}}'
# -> {"tx":{"chainId":"0x3e7","to":"0xe94b...","value":"0x14d1120d7b160000","data":"0xd96a094a...","gas":"0x..."}, ...}

cast send 0xe94bc8d4257a8bf3d37ffeca23b03d012aa58c4f \
  --rpc-url https://rpc.hyperliquid.xyz/evm --private-key "$YOUR_KEY" \
  --value 1.5ether "buy(uint256)" <minTokensOut from the quote>

curl — sell (approve step first if needed)

curl -s https://thetickeris.ai/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":5,"method":"tools/call","params":{"name":"ai_build_sell_tx","arguments":{"ai":"1000","from":"0xYOUR_ADDRESS"}}}'

# if the response includes an "approve" step:
cast send 0xe6f72e8eec40b863a5104ffa22e61076a4bd3b63 \
  --rpc-url https://rpc.hyperliquid.xyz/evm --private-key "$YOUR_KEY" \
  "approve(address,uint256)" 0xe94bc8d4257a8bf3d37ffeca23b03d012aa58c4f 1000000000000000000000

# always the "sell" step:
cast send 0xe94bc8d4257a8bf3d37ffeca23b03d012aa58c4f \
  --rpc-url https://rpc.hyperliquid.xyz/evm --private-key "$YOUR_KEY" \
  "sell(uint256,uint256)" 1000000000000000000000 <minHypeOut from the quote>

JSON mirror (same data, plain HTTP GET)

curl -s https://thetickeris.ai/api/agent/market
curl -s 'https://thetickeris.ai/api/agent/quote?side=buy&amount=1.5'
curl -s 'https://thetickeris.ai/api/agent/quote?side=sell&amount=1000'
curl -s 'https://thetickeris.ai/api/agent/tx?side=buy&amount=1.5&from=0xYOUR_ADDRESS&slippage_bps=200'
curl -s 'https://thetickeris.ai/api/agent/tx?side=sell&amount=1000&from=0xYOUR_ADDRESS'

Limits

• Amounts are decimal strings, positive, at most 18 decimal places, capped at 10000 HYPE per buy and 1000000000 ($AI's entire fixed supply) per sell.
• slippage_bps is an integer 0-5000.
• Addresses are 0x + 40 hex chars.
• Requests are rate-limited per client IP.
• A bad request returns a 400/-32602; an upstream RPC failure returns a 502 (JSON mirror) or a tools/call result with isError: true (MCP) — never a silent wrong answer.