Read-only Polygon MCP: swap quotes, venue comparison, BZB price, staking, and unsigned tx builders.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
One call to claim a posted BZB trading reward: the claim tx with a summary (amount and day), a simulation, and NOTHING_TO_CLAIM if the amount is 0. Returns an UNSIGNED tx.
Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce.
UTC day number of the trades = floor(unixSeconds / 86400), e.g. "20773" = 2026-11-16. Get it from blazar_daily_rewards (todayDayId, postedDays[].dayId).
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http blazarforce-polygon https://api.blazarforce.net/mcp
One call to claim a posted BZB trading reward: the claim tx with a summary (amount and day), a simulation, and NOTHING_TO_CLAIM if the amount is 0. Returns an UNSIGNED tx.
| Argument | Type | Description |
|---|---|---|
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| dayId* | string | UTC day number of the trades = floor(unixSeconds / 86400), e.g. "20773" = 2026-11-16. Get it from blazar_daily_rewards (todayDayId, postedDays[].dayId). |
{
"type": "object",
"required": [
"dayId",
"from"
],
"properties": {
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"dayId": {
"type": "string",
"pattern": "^\\d+$",
"description": "UTC day number of the trades = floor(unixSeconds / 86400), e.g. \"20773\" = 2026-11-16. Get it from blazar_daily_rewards (todayDayId, postedDays[].dayId)."
}
}
}One call to build an UNSIGNED contract-creation tx for a template, with named parameters per template, the predicted address, a simulation (eth_call creation) and verification settings. Never deploys. Use for launching an agent token or a staking pool on Polygon.
| Argument | Type | Description |
|---|---|---|
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| params* | any | Template and its named parameters. |
{
"type": "object",
"required": [
"from",
"params"
],
"properties": {
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"params": {
"oneOf": [
{
"type": "object",
"required": [
"template",
"name",
"symbol",
"supply",
"holder"
],
"properties": {
"name": {
"type": "string",
"maxLength": 64,
"minLength": 1,
"description": "Token name, e.g. \"Agent Token\"."
},
"holder": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Receives the entire supply at deploy."
},
"supply": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"description": "Total supply in HUMAN units (18 decimals): \"1000000\" = one million tokens."
},
"symbol": {
"type": "string",
"pattern": "^[A-Za-z0-9]{1,11}$",
"description": "Ticker, 1-11 letters/digits, e.g. \"AGT\"."
},
"template": {
"type": "string",
"const": "erc20",
"description": "Fixed-supply ERC-20, no owner, no tax."
}
}
},
{
"type": "object",
"required": [
"template",
"stakingToken",
"rewardToken",
"owner",
"durationDays"
],
"properties": {
"owner": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Can fund reward periods (Ownable2Step). Cannot touch principal."
},
"template": {
"type": "string",
"const": "staking-pool",
"description": "Synthetix-style staking pool."
},
"rewardToken": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Token paid as rewards (can equal stakingToken)."
},
"durationDays": {
"type": "integer",
"maximum": 365,
"minimum": 1,
"description": "Length of each reward period in days, 1-365."
},
"stakingToken": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Token users stake."
}
}
}
],
"description": "Template and its named parameters."
}
}
}Build an UNSIGNED approve(tokenId) or setApprovalForAll (or a revoke with approved=false) for a BlazarForce NFT, with warnings for unknown operators and approve-all. the plugin's signer refuses NFT txs.
| Argument | Type | Description |
|---|---|---|
| all | boolean | setApprovalForAll for the whole collection. |
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| tokenId | integer | Single-token approve. Omit with all=true. |
| approved | boolean | false = revoke. Default true. |
| operator* | string | Address allowed to move the NFT(s), e.g. a marketplace. |
| collection* | string | Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths). |
{
"type": "object",
"required": [
"collection",
"from",
"operator"
],
"properties": {
"all": {
"type": "boolean",
"description": "setApprovalForAll for the whole collection."
},
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"tokenId": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Single-token approve. Omit with all=true."
},
"approved": {
"type": "boolean",
"description": "false = revoke. Default true."
},
"operator": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address allowed to move the NFT(s), e.g. a marketplace."
},
"collection": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths)."
}
}
}Build an UNSIGNED safeTransferFrom for a BlazarForce NFT after checking ownership, with a simulation and warnings (irreversible, contract recipient, burn address). the plugin's signer refuses NFT txs; sign with your own wallet.
| Argument | Type | Description |
|---|---|---|
| to* | string | Recipient. |
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| tokenId* | integer | Token id (BlazarForce collections use 1..100). |
| collection* | string | Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths). |
{
"type": "object",
"required": [
"collection",
"from",
"to",
"tokenId"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Recipient."
},
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"tokenId": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Token id (BlazarForce collections use 1..100)."
},
"collection": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths)."
}
}
}One call for BZB staking: ordered txs[] (exact approve if needed, then stake / withdraw / claim / exit), a summary per tx, a simulation, and warnings (e.g. REWARDS_ENDED, NOTHING_TO_CLAIM). No lock, no fee. Returns UNSIGNED txs.
| Argument | Type | Description |
|---|---|---|
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| action* | string | stake: deposit BZB. withdraw: take back some. claim: collect rewards only. exit: withdraw all + claim. |
| amount | string | BZB in HUMAN units, e.g. "250". Required for stake and withdraw. |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
{
"type": "object",
"required": [
"action",
"from"
],
"properties": {
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"action": {
"enum": [
"stake",
"withdraw",
"claim",
"exit"
],
"type": "string",
"description": "stake: deposit BZB. withdraw: take back some. claim: collect rewards only. exit: withdraw all + claim."
},
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "BZB in HUMAN units, e.g. \"250\". Required for stake and withdraw."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
}
}
}One call for staking v2: ordered txs[] for stake (exact approve + stake), withdraw, claimAll, claimMany (defaults to only tokens with rewards), exit or emergencyWithdraw, each with a summary, a simulation, warnings, and a gas limit. withdraw / exit / emergencyWithdraw / claimAll carry gas = max(estimateGas x 1.25, 1.1M) because a cold exit can use ~885k. Returns UNSIGNED txs.
| Argument | Type | Description |
|---|---|---|
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| action* | string | stake: deposit. withdraw: take back some (the rest must stay >= minStake or be 0). claimAll: every reward token (all-or-nothing). claimMany: chosen tokens (default: tokens with rewards). exit: withdraw all + claim all. emergencyWithdraw: last resort, principal only, rewards stay claimable. |
| amount | string | Staking-token amount in HUMAN units, e.g. "250" = 250 BZB. Required for stake and withdraw. |
| tokens | array | claimMany only: reward token addresses. Default: every token where earned > 0. |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
{
"type": "object",
"required": [
"action",
"from"
],
"properties": {
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"action": {
"enum": [
"stake",
"withdraw",
"claimAll",
"claimMany",
"exit",
"emergencyWithdraw"
],
"type": "string",
"description": "stake: deposit. withdraw: take back some (the rest must stay >= minStake or be 0). claimAll: every reward token (all-or-nothing). claimMany: chosen tokens (default: tokens with rewards). exit: withdraw all + claim all. emergencyWithdraw: last resort, principal only, rewards stay claimable."
},
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "Staking-token amount in HUMAN units, e.g. \"250\" = 250 BZB. Required for stake and withdraw."
},
"tokens": {
"type": "array",
"items": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$"
},
"maxItems": 5,
"description": "claimMany only: reward token addresses. Default: every token where earned > 0."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
}
}
}One call to get everything needed to swap through BlazarFeeRouter: ordered txs[] (exact approve if needed, then swap), a plain-English summary per tx, an eth_call simulation of the swap (as if the approve were mined), the quote used, guards (minAmountOut, 3-minute deadline) and warnings[]. Use this instead of blazar_quote + blazar_decode_tx + blazar_simulate_tx. Only swaps built here (through BlazarFeeRouter) earn BZB trading rewards. Returns UNSIGNED txs; nothing is sent.
| Argument | Type | Description |
|---|---|---|
| from* | string | Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce. |
| amount* | string | Amount of tokenIn in HUMAN units, not wei: "1.5" = 1.5 POL, "250" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead. |
| tokenIn* | string | Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). "POL" is the native gas token; WPOL is the ERC-20. |
| tokenOut* | string | Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose "POL" to receive native POL (auto-unwrapped). |
| recipient | string | Who receives the output. Defaults to `from`. |
| slippageBps | integer | Max slippage in basis points (50 = 0.5%). Default 50, max 300. |
| deadlineSeconds | integer | Seconds until the swap expires. Default 150; the fee router caps it at 180. |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
| maxPriceImpactBps | integer | Refuse with INSUFFICIENT_LIQUIDITY above this impact. Default 3000 (30%). |
{
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"from"
],
"properties": {
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address that will sign and send the txs. Required: used for allowance checks, simulation and nonce."
},
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "Amount of tokenIn in HUMAN units, not wei: \"1.5\" = 1.5 POL, \"250\" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead."
},
"tokenIn": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). \"POL\" is the native gas token; WPOL is the ERC-20."
},
"tokenOut": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose \"POL\" to receive native POL (auto-unwrapped)."
},
"recipient": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Who receives the output. Defaults to `from`."
},
"slippageBps": {
"type": "integer",
"maximum": 300,
"minimum": 1,
"description": "Max slippage in basis points (50 = 0.5%). Default 50, max 300."
},
"deadlineSeconds": {
"type": "integer",
"maximum": 180,
"minimum": 30,
"description": "Seconds until the swap expires. Default 150; the fee router caps it at 180."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
},
"maxPriceImpactBps": {
"type": "integer",
"maximum": 10000,
"minimum": 1,
"description": "Refuse with INSUFFICIENT_LIQUIDITY above this impact. Default 3000 (30%)."
}
}
}Off-chain limit-order check for a bot: is the executable BlazarFeeRouter price for this size (after fees and impact) at or above limitPrice (tokenOut per 1 tokenIn)? Returns triggered, gapBps and the exact blazar_build_swap args to use. Never sends anything.
| Argument | Type | Description |
|---|---|---|
| amount* | string | Amount of tokenIn in HUMAN units, not wei: "1.5" = 1.5 POL, "250" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead. |
| tokenIn* | string | Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). "POL" is the native gas token; WPOL is the ERC-20. |
| tokenOut* | string | Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose "POL" to receive native POL (auto-unwrapped). |
| limitPrice* | string | Minimum tokenOut per 1 tokenIn, e.g. "12.5" BZB per POL. |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
{
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"limitPrice"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "Amount of tokenIn in HUMAN units, not wei: \"1.5\" = 1.5 POL, \"250\" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead."
},
"tokenIn": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). \"POL\" is the native gas token; WPOL is the ERC-20."
},
"tokenOut": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose \"POL\" to receive native POL (auto-unwrapped)."
},
"limitPrice": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"description": "Minimum tokenOut per 1 tokenIn, e.g. \"12.5\" BZB per POL."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
}
}
}Compare one swap across venues before trading: the best BlazarFeeRouter route, the best route on each single venue (BlazarSwap, QuickSwap V2, SushiSwap V2) through the fee router and as a direct pool swap, and a ParaSwap reference price (public API, no key). Each row says rewardsEligible and buildableHere, plus behindBestBps. Read-only. Use when the user asks 'is this the best price?'
| Argument | Type | Description |
|---|---|---|
| amount* | string | Amount of tokenIn in HUMAN units, not wei: "1.5" = 1.5 POL, "250" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead. |
| tokenIn* | string | Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). "POL" is the native gas token; WPOL is the ERC-20. |
| tokenOut* | string | Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose "POL" to receive native POL (auto-unwrapped). |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
| includeAggregator | boolean | Include the ParaSwap reference price (public API). Default true. |
{
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "Amount of tokenIn in HUMAN units, not wei: \"1.5\" = 1.5 POL, \"250\" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead."
},
"tokenIn": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). \"POL\" is the native gas token; WPOL is the ERC-20."
},
"tokenOut": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose \"POL\" to receive native POL (auto-unwrapped)."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
},
"includeAggregator": {
"type": "boolean",
"description": "Include the ParaSwap reference price (public API). Default true."
}
}
}BlazarForce contract addresses on Polygon (router, factory, fee router, staking, daily rewards, oracle, BZB) plus the pair init code hash. Use when you need an address or ABI link; blazar_overview already includes these.
No arguments.
{
"type": "object",
"properties": {}
}How much BZB one address can claim for one posted trading-reward day. Read-only. Get dayId from blazar_daily_rewards.postedDays.
| Argument | Type | Description |
|---|---|---|
| dayId* | string | UTC day number of the trades = floor(unixSeconds / 86400), e.g. "20773" = 2026-11-16. Get it from blazar_daily_rewards (todayDayId, postedDays[].dayId). |
| account* | string | Address to check. |
{
"type": "object",
"required": [
"dayId",
"account"
],
"properties": {
"dayId": {
"type": "string",
"pattern": "^\\d+$",
"description": "UTC day number of the trades = floor(unixSeconds / 86400), e.g. \"20773\" = 2026-11-16. Get it from blazar_daily_rewards (todayDayId, postedDays[].dayId)."
},
"account": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Address to check."
}
}
}BZB daily trading-rewards status for swaps through BlazarFeeRouter: today's dayId, recently posted days with totals and claim deadlines, daily cap, contract balance, and scoring rules. Use it to find a dayId before blazar_daily_claimable or blazar_build_claim.
No arguments.
{
"type": "object",
"properties": {}
}Decode calldata for a tx to a BlazarForce contract or an ERC-20 approve, e.g. one from another tool or agent, so you can check it before signing. Builds already include summaries, so this is for txs from other sources.
| Argument | Type | Description |
|---|---|---|
| to* | string | |
| data* | string |
{
"type": "object",
"required": [
"to",
"data"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$"
},
"data": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]*$"
}
}
}List the contract templates this plugin can build deploy txs for: a fixed-supply ERC-20 (no owner, no tax) and a Synthetix-style staking pool. Unaudited. Use before blazar_build_deploy.
No arguments.
{
"type": "object",
"properties": {}
}Earning options on BlazarForce ranked from live onchain reads only (no projections): BZB staking, BlazarSwap LP positions with reserves, trading rewards, and the BZB cross-venue spread. alerts[] at the top flags ended rewards and thin liquidity. Use when the user asks how to earn with BZB or POL here.
| Argument | Type | Description |
|---|---|---|
| includeVolume | boolean | Add 24h swap volume per BlazarSwap pool from Swap events (slower, ~5 s). |
{
"type": "object",
"properties": {
"includeVolume": {
"type": "boolean",
"description": "Add 24h swap volume per BlazarSwap pool from Swap events (slower, ~5 s)."
}
}
}BlazarForce NFT collections on Polygon (Sleepy Validators, Night Market Stubs, Crystal Moths): live name, supply, holder count, top holders, interfaces, sample token URI, site-stated ask, marketplace links. Read-only.
No arguments.
{
"type": "object",
"properties": {}
}Who owns a BlazarForce NFT (tokenId), or which token ids an address holds (owner), with metadata and marketplace operator approvals. Read-only.
| Argument | Type | Description |
|---|---|---|
| owner | string | List the token ids this address holds. |
| tokenId | integer | Look up one token's owner and metadata. |
| collection* | string | Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths). |
{
"type": "object",
"required": [
"collection"
],
"properties": {
"owner": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "List the token ids this address holds."
},
"tokenId": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Look up one token's owner and metadata."
},
"collection": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths)."
}
}
}Listing info for a BlazarForce NFT: owner, the site-stated ask, on-chain marketplace approvals (OpenSea Seaport conduit), and live Rarible orders only if RARIBLE_API_KEY is set in your env. There is no on-chain BlazarForce marketplace.
| Argument | Type | Description |
|---|---|---|
| tokenId | integer | Default 1. |
| collection* | string | Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths). |
{
"type": "object",
"required": [
"collection"
],
"properties": {
"tokenId": {
"type": "integer",
"maximum": 100000,
"minimum": 1,
"description": "Default 1."
},
"collection": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Collection symbol, id or address: SLPV (Sleepy Validators), STUB (Night Market Stubs), MOTH (Crystal Moths)."
}
}
}START HERE. One call that returns what is live on BlazarForce right now: contract addresses, fees (5 bps wrapper, 30 bps pool), top BlazarSwap pools, BZB price per venue, staking and trading-reward status (e.g. REWARDS_ENDED with date), and which tool to use for what. Use it first in a session, or when unsure which tool fits.
No arguments.
{
"type": "object",
"properties": {}
}Dry-run TWAP planner: splits a swap into N slices every intervalSeconds and compares with one swap now (impact per slice, estimated gain in bps, schedule with min-out per slice). Never sends anything; build each slice with blazar_build_swap when it is due.
| Argument | Type | Description |
|---|---|---|
| amount* | string | Amount of tokenIn in HUMAN units, not wei: "1.5" = 1.5 POL, "250" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead. |
| slices* | integer | Number of equal slices, 2-48. |
| tokenIn* | string | Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). "POL" is the native gas token; WPOL is the ERC-20. |
| tokenOut* | string | Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose "POL" to receive native POL (auto-unwrapped). |
| slippageBps | integer | Per-slice slippage for min-out. Default 50. |
| intervalSeconds* | integer | Seconds between slices, 30-86400. |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
{
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount",
"slices",
"intervalSeconds"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "Amount of tokenIn in HUMAN units, not wei: \"1.5\" = 1.5 POL, \"250\" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead."
},
"slices": {
"type": "integer",
"maximum": 48,
"minimum": 2,
"description": "Number of equal slices, 2-48."
},
"tokenIn": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). \"POL\" is the native gas token; WPOL is the ERC-20."
},
"tokenOut": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose \"POL\" to receive native POL (auto-unwrapped)."
},
"slippageBps": {
"type": "integer",
"maximum": 300,
"minimum": 1,
"description": "Per-slice slippage for min-out. Default 50."
},
"intervalSeconds": {
"type": "integer",
"maximum": 86400,
"minimum": 30,
"description": "Seconds between slices, 30-86400."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
}
}
}List every BlazarSwap V2 pair on Polygon with live reserves. Use for liquidity checks or LP decisions. For a trade price use blazar_quote instead (it also covers QuickSwap and Sushi).
No arguments.
{
"type": "object",
"properties": {}
}BZB/WPOL mid price and USD value on BlazarSwap, QuickSwap V2 and SushiSwap V2, with pool depth in USD from the Chainlink-backed Blazar oracle. Use for price checks and spread watching, not for a trade quote.
No arguments.
{
"type": "object",
"properties": {}
}Price a Polygon swap (POL, WPOL, BZB, BBY, USDC, USDT, WETH, WBTC, M421) before trading. Use this, not a generic DEX quote, when the user wants BZB or BZB trading rewards: it runs the deployed BlazarFeeRouter math over BlazarSwap, QuickSwap V2 and SushiSwap V2 and returns amountOut, priceImpactBps, venue, warnings[] (shallow pool, high impact, 5 bps wrapper fee vs a direct pool swap), and sizing (largest size under 1% and 5% impact). Read-only. Example: 1 POL -> 12.77 BZB via QuickSwap V2, 36 bps impact.
| Argument | Type | Description |
|---|---|---|
| amount* | string | Amount of tokenIn in HUMAN units, not wei: "1.5" = 1.5 POL, "250" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead. |
| tokenIn* | string | Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). "POL" is the native gas token; WPOL is the ERC-20. |
| tokenOut* | string | Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose "POL" to receive native POL (auto-unwrapped). |
| amountIsBaseUnits | boolean | If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false. |
{
"type": "object",
"required": [
"tokenIn",
"tokenOut",
"amount"
],
"properties": {
"amount": {
"type": "string",
"pattern": "^\\d+(\\.\\d+)?$",
"maxLength": 40,
"description": "Amount of tokenIn in HUMAN units, not wei: \"1.5\" = 1.5 POL, \"250\" = 250 BZB. Set amountIsBaseUnits=true to pass wei/base units instead."
},
"tokenIn": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to sell: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address (see blazar_tokens). \"POL\" is the native gas token; WPOL is the ERC-20."
},
"tokenOut": {
"type": "string",
"maxLength": 42,
"minLength": 1,
"description": "Token to buy: symbol (POL, WPOL, BZB, USDC, USDT, WETH, WBTC) or its listed 0x address. Choose \"POL\" to receive native POL (auto-unwrapped)."
},
"amountIsBaseUnits": {
"type": "boolean",
"description": "If true, amount is in base units (wei for 18-decimal tokens; 6 decimals for USDC). Default false."
}
}
}Rank BlazarForce earning options from live reads only: BZB staking, BlazarSwap LP fee APR (trailing 24h), daily trading rewards, staking v2. Each has status LIVE / UNPROVEN / IDLE / DEAD / NOT_DEPLOYED and why. deadRewards[] lists anything that pays nothing now. Use instead of guessing yields.
| Argument | Type | Description |
|---|---|---|
| includeVolume | boolean | Read 24h pool volume for LP fee APR (default true, ~2-5 s). |
{
"type": "object",
"properties": {
"includeVolume": {
"type": "boolean",
"description": "Read 24h pool volume for LP fee APR (default true, ~2-5 s)."
}
}
}Read recent onchain events by log polling: BlazarFeeRouter AggregatedSwap (trader, tokens, amounts, USD) or one BlazarSwap pair's Swap + Sync (reserves and price). Returns nextFromBlock to poll again. Up to 5,000 blocks per call (about 2 hours).
| Argument | Type | Description |
|---|---|---|
| pair | string | BlazarSwap pair address (source=pair). From blazar_pools. |
| blocks | integer | Blocks to scan, max 5000. Default 900 (~30 min). |
| source* | string | feeRouter: AggregatedSwap events. pair: Swap + Sync on one BlazarSwap pair. |
| fromBlock | string | Start block (use nextFromBlock from the last call). Default: head - blocks + 1. |
{
"type": "object",
"required": [
"source"
],
"properties": {
"pair": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "BlazarSwap pair address (source=pair). From blazar_pools."
},
"blocks": {
"type": "integer",
"maximum": 5000,
"minimum": 1,
"description": "Blocks to scan, max 5000. Default 900 (~30 min)."
},
"source": {
"enum": [
"feeRouter",
"pair"
],
"type": "string",
"description": "feeRouter: AggregatedSwap events. pair: Swap + Sync on one BlazarSwap pair."
},
"fromBlock": {
"type": "string",
"pattern": "^\\d+$",
"description": "Start block (use nextFromBlock from the last call). Default: head - blocks + 1."
}
}
}Dry-run any Polygon tx with eth_call + estimateGas from `from` (POL balance overridden, token balances real). Returns ok, gas, or an error code with a hint. Use for txs from other sources; builds already simulate.
| Argument | Type | Description |
|---|---|---|
| to | string | Omit for contract creation. |
| data* | string | |
| from* | string | |
| value | string | Wei, default 0. |
{
"type": "object",
"required": [
"from",
"data"
],
"properties": {
"to": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Omit for contract creation."
},
"data": {
"type": "string",
"pattern": "^0x[0-9a-fA-F]*$"
},
"from": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$"
},
"value": {
"type": "string",
"pattern": "^\\d+$",
"description": "Wei, default 0."
}
}
}BZB single-sided staking (BlazarStakingRewards): status first (ACTIVE or REWARDS_ENDED with date), live APR from the reward rate, total staked, and optionally one account's stake, earned BZB and allowance. Use before building a stake, or to check rewards.
| Argument | Type | Description |
|---|---|---|
| account | string | Optional: include this address's stake, earned BZB and allowance. |
{
"type": "object",
"properties": {
"account": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Optional: include this address's stake, earned BZB and allowance."
}
}
}BlazarMultiRewardStaking (staking v2: stake BZB, earn up to 5 reward tokens, no lock). Live at 0x4222bFF08cc9D42cd3311033a4882314DfE19615. One call returns status/alerts first, minStake, totalStaked, every reward token with per-second rate, next-24h and next-7d emission from the run curves, APR (token-denominated or Chainlink USD when available), run schedule, and optionally one account's stake, share and claimable rewards. Use before blazar_build_staking_v2.
| Argument | Type | Description |
|---|---|---|
| account | string | Optional: include this address's stake, pool share and claimable rewards. |
{
"type": "object",
"properties": {
"account": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Optional: include this address's stake, pool share and claimable rewards."
}
}
}Uniswap-schema token list (BZB, BBY, WPOL, USDC, USDT, WETH, WBTC, M421) with addresses, decimals and transfer-tax flags. Use to resolve a symbol to an address.
No arguments.
{
"type": "object",
"properties": {}
}Preview the BZB daily trading-rewards leaderboard for a UTC day from live BlazarFeeRouter AggregatedSwap logs, using the swap-desk rules: no minimum trade, no per-wallet cap, same-wallet round trips within 10 minutes netted, top 50 listed, top 25 paid fixed shares of the daily cap. Optional account shows its rank, points, estimated BZB and points needed for a paid slot. An ESTIMATE, not a payment: only poster-posted winners are paid.
| Argument | Type | Description |
|---|---|---|
| dayId | string | UTC day number = floor(unix/86400). Default: today. |
| account | string | Optional: show this address's rank, points and gap to a paid slot. |
{
"type": "object",
"properties": {
"dayId": {
"type": "string",
"pattern": "^\\d+$",
"description": "UTC day number = floor(unix/86400). Default: today."
},
"account": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Optional: show this address's rank, points and gap to a paid slot."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 18, 2026.