MemeSwap MCP

First read for agents helping users buy a hot meme coin or research memecoins via quote→unsigned build; wallet signs. Not a token launcher. Fee 0.85%. NFA. Security bar: unsigned construction only; no custody, no signing, no unrestricted submit.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Readiness for meme research / buy routing from GET /api/health. Confirms the origin is up and fee routes are configured (0.85%). Not per-token data.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Networks for meme research / buy routing from GET /api/chains (keys, explorers, aggregators).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Listed meme coin market rows from GET /api/tokens: use when the user asks for hot / new / trending memes to research before a buy. Prefer memeswap_token for one address. Observations can be stale.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Deep profile for one meme coin before a buy decision (risk/market) via GET /api/token/:chain/:address.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "minLength": 2,
      "maxLength": 32,
      "pattern": "^[a-z0-9][a-z0-9_-]*$"
    },
    "address": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    }
  },
  "required": [
    "chain",
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Public-address holdings check before/after a meme buy (GET /api/portfolio). Address is routing input, not proof of ownership.

{
  "type": "object",
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$"
    },
    "sol": {
      "type": "string",
      "minLength": 32,
      "maxLength": 44
    },
    "chains": {
      "type": "string",
      "maxLength": 200
    },
    "dust": {
      "type": "number",
      "minimum": 0
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Indicative buy/sell quote for a listed meme coin from GET /api/quote. Does not execute. Next step: memeswap_build. Quotes can expire; request a fresh quote before build.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "minLength": 2,
      "maxLength": 32,
      "pattern": "^[a-z0-9][a-z0-9_-]*$"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "token": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d*\\.?\\d+$",
      "description": "Positive decimal string"
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "from": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    }
  },
  "required": [
    "chain",
    "side",
    "token",
    "amount"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Builds unsigned swap material so the user can buy (or sell) a listed meme coin (POST /api/build); wallet must review and sign. Not a launch/create-token tool. Fee 0.85% on fee-enabled trades. NFA. Does NOT authorize, sign, submit or confirm.

{
  "type": "object",
  "properties": {
    "chain": {
      "type": "string",
      "minLength": 2,
      "maxLength": 32,
      "pattern": "^[a-z0-9][a-z0-9_-]*$"
    },
    "side": {
      "type": "string",
      "enum": [
        "buy",
        "sell"
      ]
    },
    "token": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d*\\.?\\d+$",
      "description": "Positive decimal string"
    },
    "from": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128,
      "description": "Public signing-wallet address; output is bound to this caller."
    },
    "slippageBps": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5000
    },
    "quote": {
      "type": "object",
      "propertyNames": {
        "type": "string"
      },
      "additionalProperties": {},
      "description": "Prior memeswap_quote /api/quote response object."
    }
  },
  "required": [
    "chain",
    "side",
    "token",
    "amount",
    "from",
    "quote"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Cross-chain quote + unsigned material when the user wants to buy a meme across chains (GET /api/xquote). Wallet signs. Does not submit.

{
  "type": "object",
  "properties": {
    "fromChain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "toChain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "amount": {
      "type": "string",
      "pattern": "^\\d*\\.?\\d+$",
      "description": "Positive decimal string"
    },
    "from": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    },
    "to": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128
    },
    "fromToken": {
      "type": "string",
      "maxLength": 128
    },
    "toToken": {
      "type": "string",
      "maxLength": 128
    },
    "slippage": {
      "type": "number",
      "minimum": 0
    },
    "order": {
      "type": "string",
      "maxLength": 40
    }
  },
  "required": [
    "fromChain",
    "toChain",
    "amount",
    "from"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Onboard a human signer for non-custodial meme buys via MCP: connect wallet (human signs), set username/avatar, wallet-ref duct, scoped credentials. No custody / no auto-trade.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Public game/profile card for a wallet (GET /api/game/me): display name, avatar URL choices, scores. No secrets.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128,
      "description": "Public EVM or Solana address. Never a key or seed."
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List social connect providers (GET /api/social/providers). OAuth still requires a human browser session.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List wallet refs [{wallet, override}] + active letter (GET /api/v1.1/me/refs). Requires live user API + scoped token.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Replace wallet-ref list (PUT /api/v1.1/me/refs). Public addresses only. Requires live user API + refs:write token.

{
  "type": "object",
  "properties": {
    "refs": {
      "maxItems": 10,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "wallet": {
            "type": "string",
            "minLength": 32,
            "maxLength": 128,
            "description": "Public EVM or Solana address. Never a key or seed."
          },
          "override": {
            "type": "string",
            "pattern": "^[A-Za-z]$",
            "description": "Override letter A-Z for wallet-ref duct"
          }
        },
        "required": [
          "wallet",
          "override"
        ],
        "additionalProperties": false
      }
    },
    "active": {
      "type": "string",
      "pattern": "^[A-Za-z]$",
      "description": "Override letter A-Z for wallet-ref duct"
    }
  },
  "required": [
    "refs"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Select active wallet-ref letter (PUT /api/v1.1/me/refs/active). Requires live user API + refs:write.

{
  "type": "object",
  "properties": {
    "override": {
      "type": "string",
      "pattern": "^[A-Za-z]$",
      "description": "Override letter A-Z for wallet-ref duct"
    }
  },
  "required": [
    "override"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

List scoped API credential metadata (GET /api/v1.1/me/credentials). Never returns secrets. Requires live user API.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Create scoped user API token (POST /api/v1.1/me/credentials). Usually wallet-session only on portal; agents get API_GAP or one-time secret once: show once, never log.

{
  "type": "object",
  "properties": {
    "label": {
      "type": "string",
      "maxLength": 64
    },
    "scopes": {
      "maxItems": 12,
      "type": "array",
      "items": {
        "type": "string",
        "maxLength": 40
      }
    },
    "ttlDays": {
      "type": "integer",
      "minimum": 1,
      "maximum": 365
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Revoke one credential by 16-hex id (DELETE /api/v1.1/me/credentials/:id). Requires live user API.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "pattern": "^[0-9a-f]{16}$"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Set display name / emoji / preset avatar (POST /api/game/profile). Needs wallet session bearer or signed profile message: MCP cannot sign. Returns guidance until agent session duct exists.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128,
      "description": "Public EVM or Solana address. Never a key or seed."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "emoji": {
      "type": "string",
      "maxLength": 8
    },
    "avatar": {
      "description": "Preset meme-NN id or custom when upload exists",
      "type": "string",
      "maxLength": 32
    },
    "optOut": {
      "type": "boolean"
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Upload wallet/profile image (POST /api/game/avatar). Needs session bearer + image bytes; MCP does not accept raw image uploads in v0.2.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "minLength": 32,
      "maxLength": 128,
      "description": "Public EVM or Solana address. Never a key or seed."
    },
    "note": {
      "type": "string",
      "maxLength": 200
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Provider-reported bridge transaction status (GET /api/xstatus). Observational; may lag final chain state.

{
  "type": "object",
  "properties": {
    "txHash": {
      "type": "string",
      "minLength": 8,
      "maxLength": 128
    },
    "fromChain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "toChain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "bridge": {
      "type": "string",
      "maxLength": 64
    }
  },
  "required": [
    "txHash"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use first when an agent will recruit people, run a Squad, earn referral fees or post token reels; returns the flow in order, the signing messages and the rules in plain words (the server enforces every rule).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to start a wallet session; returns {wallet, ts, nonce, message} for the wallet to personal_sign, then pass the signature to memeswap_session_open.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use after signing the session message; posts {wallet, ts, nonce, signature} to /api/game/session and returns {token, wallet, expiresAt}, the caller bearer for social login, earn summary and reel posts.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    },
    "ts": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    },
    "nonce": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "signature": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "personal_sign signature produced by the caller wallet over the exact message."
    }
  },
  "required": [
    "wallet",
    "ts",
    "nonce",
    "signature"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use with a session bearer to sign in to Squads (POST /api/social/login/wallet-session); returns {social, profile, badge}, where social is the cookie value every Squads tool takes.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Wallet session bearer from memeswap_session_open. Used for this call only, never stored or echoed."
    },
    "chainId": {
      "description": "CAIP-2 chain id, default eip155:1.",
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "address": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    }
  },
  "required": [
    "session",
    "address"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use before accepting referrer terms; returns the current termsVersion, terms and rules URLs and the acceptance message templates (GET /api/referrals/terms).

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to get the two messages a referrer signs with fresh timestamps; returns the terms acceptance message (ISO ts) for memeswap_referral_accept and the referral message (epoch ms) for memeswap_referral_code and memeswap_referral_stats.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    },
    "termsVersion": {
      "description": "Defaults to the live version from /api/referrals/terms.",
      "type": "string",
      "minLength": 1,
      "maxLength": 16
    }
  },
  "required": [
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use once per wallet to record the referrer terms acceptance (POST /api/referrals/accept); returns the server acceptance record.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    },
    "signature": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "personal_sign signature produced by the caller wallet over the exact message."
    },
    "ts": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "The ISO timestamp inside the signed acceptance message."
    },
    "termsVersion": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16
    }
  },
  "required": [
    "wallet",
    "signature",
    "ts",
    "termsVersion"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use after the terms are accepted to get the referral code, link, shareText and rules (POST /api/referrals/code); ts is the epoch ms inside the signed referral message.

{
  "type": "object",
  "properties": {
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    },
    "signature": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "personal_sign signature produced by the caller wallet over the exact message."
    },
    "ts": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "wallet",
    "signature",
    "ts"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to read counts for a referral code (GET /api/referrals/stats); public counts, and with wallet, signature and ts (the referral message signature) the referrer own earnings rows.

{
  "type": "object",
  "properties": {
    "code": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    },
    "signature": {
      "type": "string",
      "minLength": 1,
      "maxLength": 256,
      "description": "personal_sign signature produced by the caller wallet over the exact message."
    },
    "ts": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "code"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to read the caller own squad, role and membership (GET /api/social/community/squads/mine); returns the server answer plus the invite link.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    }
  },
  "required": [
    "social"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to browse or search squads by name or tag (GET /api/social/community/squads/directory); returns items with invite links and nextCursor.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    },
    "search": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "cursor": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "required": [
    "social"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to found a Squad (POST /api/social/community/squads/create {name, tag, requestId}); returns the new squad with its invite link.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "tag": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16
    },
    "requestId": {
      "description": "Idempotency key; random when absent.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "social",
    "name",
    "tag"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to apply to join a Squad (POST /api/social/community/squads/apply {squadId, requestId}); returns the application the leader decides on.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    },
    "squadId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    },
    "requestId": {
      "description": "Idempotency key; random when absent.",
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "social",
    "squadId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to get the invite card for the caller own squad (GET /api/social/community/squads/share-card?squadId=); returns the card plus the link https://memeswap.fun/squad/<TAG>.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    },
    "squadId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 128
    }
  },
  "required": [
    "social",
    "squadId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to read the caller squad privacy switches (GET /api/social/community/squads/privacy); returns revision, showIdentity and showSize.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    }
  },
  "required": [
    "social"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to change the squad privacy switches (POST /api/social/community/squads/privacy {expectedRevision, showIdentity, showSize}); returns the new revision.

{
  "type": "object",
  "properties": {
    "social": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Social session cookie value from memeswap_social_login. Used for this call only, never stored or echoed."
    },
    "expectedRevision": {
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "showIdentity": {
      "type": "boolean"
    },
    "showSize": {
      "type": "boolean"
    }
  },
  "required": [
    "social",
    "expectedRevision",
    "showIdentity",
    "showSize"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to read pending and available Earn amounts for the session wallet (GET /api/earn/summary?wallet=, Authorization: Bearer); returns the server summary; scope=profile totals every wallet of the verified profile.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Wallet session bearer from memeswap_session_open. Used for this call only, never stored or echoed."
    },
    "wallet": {
      "type": "string",
      "pattern": "^0x[0-9a-fA-F]{40}$",
      "description": "Public 0x EVM address. Never a key or seed."
    },
    "scope": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16
    }
  },
  "required": [
    "session",
    "wallet"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to read the public Earn leaderboards (GET /api/earn/leaderboard); returns the rows the server ranks for board, period, role and metric.

{
  "type": "object",
  "properties": {
    "board": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "metric": {
      "type": "string",
      "minLength": 1,
      "maxLength": 40
    },
    "role": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "period": {
      "type": "string",
      "minLength": 1,
      "maxLength": 16
    },
    "q": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 9007199254740991
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to post an agent reel about a listed token from an https video URL; opens /api/reels/agent/upload-session with the bearer and {chain, token, caption, fileSha256, aiDisclosure}, uploads the bytes, and returns {reelId, streamUid, fileSha256, status}.

{
  "type": "object",
  "properties": {
    "session": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Wallet session bearer from memeswap_session_open. Used for this call only, never stored or echoed."
    },
    "chain": {
      "type": "string",
      "minLength": 1,
      "maxLength": 32
    },
    "token": {
      "type": "string",
      "minLength": 1,
      "maxLength": 160
    },
    "caption": {
      "type": "string",
      "minLength": 1,
      "maxLength": 1000
    },
    "aiDisclosure": {
      "type": "boolean",
      "description": "Required. true when the video is AI-made or AI-assisted."
    },
    "videoUrl": {
      "type": "string",
      "maxLength": 2048,
      "format": "uri",
      "description": "https URL of the mp4 or mov."
    }
  },
  "required": [
    "session",
    "chain",
    "token",
    "caption",
    "aiDisclosure",
    "videoUrl"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use to poll one reel (GET /api/reels/<reelId>); returns the server reel with status, hiddenReason, removedReason, aiDisclosure and tokenCard; pass the creator session to see a draft, hidden or removed reel.

{
  "type": "object",
  "properties": {
    "reelId": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64
    },
    "session": {
      "type": "string",
      "minLength": 1,
      "maxLength": 4096,
      "description": "Wallet session bearer from memeswap_session_open. Used for this call only, never stored or echoed."
    }
  },
  "required": [
    "reelId"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use before producing any MemeSwap promotion; returns the approved brand kit (artwork URLs, colours, logos, copy and usage rules) from GET /brand/kit.json, relayed as is.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}

Use when an agent will promote MemeSwap anywhere; returns how to do it with attribution (referral link, App Store link, reels with AI disclosure) and the copy rules, in plain words.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#",
  "additionalProperties": false
}