MCP 服务器

Clearvoyance

ai.clearvoyance/clearvoyance
数据与分析 营销与广告 公开且可连接 MCP 2025-11-25

此 MCP 可以做什么

Runs anonymous voice or text feedback campaigns and produces AI-generated summaries, themes, sentiment, and quoted insights.

analyze_campaign
Analyse the answers
Runs the AI analysis over every answer so far and returns an executive summary with themes, sentiment and quotes; the report is then also part of get_campaign_results. Re-running with no new answers returns the same report. A sandbox campaign gets the illustrative sample report, marked sample: true.
可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'campaignId'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'campaignId': {'type': 'integer', 'description': 'A campaign id from launch_campaign or list_my_campaigns', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
check_topup
Check a card top-up
Whether a card top-up session has been paid and credited. Safe to call repeatedly; credits at most once.
可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'sessionId'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'sessionId': {'type': 'string', 'description': 'The sessionId create_card_topup returned (cs_â\x80¦)'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
close_account
Close the account and refund the balance
Closes the account and refunds what is left of the balance to the card(s) that paid, newest top-up first, less Stripe's processing fee on each payment refunded (Stripe keeps it; the account owner bears it). Call it WITHOUT confirm first: that only previews the refund per card and moves nothing. Then, only if the account owner has agreed, call again with confirm: true. Every campaign must be closed first. A refund the card refuses stays as credit, and the key keeps working while any credit remains. Once the balance is zero the key is revoked for good. Sandbox accounts: the key is revoked and nothing is refunded (the credit is notional). If Stripe does not answer, call again to finish.
可能执行破坏性操作 可访问外部资源 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'confirm': {'type': 'boolean', 'description': 'true to actually close and refund. Omit or false to preview only.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
close_campaign
Close a campaign
Ends the campaign now: no more answers are accepted. The price was charged at launch, so closing early refunds nothing. Campaigns also close on their own at the cap or on expiry. Closing twice changes nothing.
可能执行破坏性操作 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'campaignId'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'campaignId': {'type': 'integer', 'description': 'A campaign id from launch_campaign or list_my_campaigns', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
create_account
Create an account
Creates an agent account and returns its API key ONCE — store it; it is not kept anywhere and cannot be shown again. No email, no password, nothing personal: the account is a key and a balance. mode 'sandbox' gives a cv_test_ key with $20.00 of notional balance — the same API, no money moves, no email is sent (a sandbox targeted campaign returns its invitation links instead of sending them). mode 'live' (default) starts at $0 and needs a top-up before a campaign can launch. Free; limited to 10 accounts per hour per address.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'mode': {'enum': ['live', 'sandbox'], 'type': 'string', 'description': "Default 'live'. Use 'sandbox' to try everything with a notional balance."}, 'label': {'type': 'string', 'maxLength': 80, 'description': "Optional name for the account, chosen by you (e.g. 'acme-shop post-purchase bot')"}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
create_campaign
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). (launch_campaign is its equivalent for the key flow.) Creates a new anonymous audio feedback campaign. Two modes: (a) INCENTIVIZED — participants earn USDC rewards; you must fund an escrow address returned in the response, then call verify_campaign_funding. Participants have 30 days after the campaign ends to claim; anything unclaimed then goes back to the wallet you signed in with. (b) NO_REWARD — survey only, no crypto rewards; you pay a flat Stripe activation fee (returned in activationRequired), then call verify_campaign_activation. The accessToken is single-use and is consumed on success. Privacy threshold: minPercent enforces the minimum response rate before results are unlocked (minimum 50%). Campaign expiry: 1–42 days (default 7).
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['accessToken', 'title', 'description', 'questions', 'cohortEmails', 'rewardMode'], 'properties': {'title': {'type': 'string', 'description': 'Campaign title (shown to participants)'}, 'questions': {'type': 'array', 'items': {'type': 'object', 'required': ['text'], 'properties': {'text': {'type': 'string', 'description': 'Question text'}}, 'additionalProperties': False}, 'minItems': 1, 'description': 'List of audio questions for participants to answer'}, 'minPercent': {'type': 'number', 'maximum': 100, 'minimum': 50, 'description': 'Minimum response rate (%) required to unlock results. Defaults to 50.'}, 'rewardMint': {'type': 'string', 'description': 'SPL token mint address for rewards. Defaults to USDC if omitted.'}, 'rewardMode': {'enum': ['INCENTIVIZED', 'NO_REWARD'], 'type': 'string', 'description': 'INCENTIVIZED: crypto rewards per response. NO_REWARD: survey only, flat activation fee.'}, 'accessToken': {'type': 'string', 'description': 'One-time access token from initialize_session (free sessions) or verify_payment'}, 'description': {'type': 'string', 'description': 'Short description of the campaign purpose'}, 'cohortEmails': {'type': 'array', 'items': {'type': 'string', 'format': 'email'}, 'minItems': 2, 'description': 'Email addresses of participants (minimum 2 for privacy)'}, 'expiresInDays': {'type': 'integer', 'maximum': 42, 'minimum': 1, 'description': 'Campaign duration in days (1â\x80\x9342, default 7)'}, 'incentiveCents': {'type': 'integer', 'description': 'Reward per participant in cents (e.g. 500 = $5.00). Required for INCENTIVIZED.'}, 'digitalGiftText': {'type': 'string', 'description': 'Optional digital gift description shown to NO_REWARD participants (e.g. a discount code)'}}, 'additionalProperties': False}
create_card_topup
Top up by card
Creates a Stripe Checkout link for a PERSON to pay with a card; hand them the checkoutUrl. Live accounts only, $4.99 to $1,000.00. Nothing is credited until they pay. Then call check_topup with the sessionId until credited is true — the balance is credited once, by whichever of Stripe's webhook, check_topup or the payer's own page sees the payment first.
可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'amountCents'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'amountCents': {'type': 'integer', 'description': 'US cents, e.g. 2000 for $20.00. Minimum 499.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
export_campaign_data
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). (get_campaign_results is its equivalent for the key flow, as JSON with the AI report.) Exports raw response data for a completed campaign as CSV text. Each row contains a response ID, submission timestamp, and one column per question with the participant's audio transcription as the value. Only available after campaign expiry. AI insight reports are not included (raw data only). Data is deleted 30 days after the first export — check agentDataExpiresAt from get_campaign_details. Requires the sessionToken from verify_login_signature.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaignId', 'sessionToken'], 'properties': {'campaignId': {'type': 'integer', 'description': 'Campaign ID to export'}, 'sessionToken': {'type': 'string', 'description': 'Session token from verify_login_signature'}}, 'additionalProperties': False}
get_account
Account and balance
The account behind a key: mode, balance, what is available to launch with, the declared deposit wallet.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
get_agent_config
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). Returns the agent session configuration: whether a session fee applies (paymentRequired), the fee in cents, the accepted token mint (USDC on Solana) and the treasury wallet address.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
get_campaign
Campaign status
One campaign: status, answers so far, invitations sent or the cap, the share link, the privacy threshold and whether it is met, and the price charged.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'campaignId'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'campaignId': {'type': 'integer', 'description': 'A campaign id from launch_campaign or list_my_campaigns', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
get_campaign_details
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). (get_campaign is its equivalent for the key flow.) Returns detailed stats for a specific campaign: invite count, response count, completion rate, question definitions, and campaign status. Only campaigns owned by your wallet are accessible. Requires the sessionToken from verify_login_signature.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaignId', 'sessionToken'], 'properties': {'campaignId': {'type': 'integer', 'description': 'Campaign ID to inspect'}, 'sessionToken': {'type': 'string', 'description': 'Session token from verify_login_signature'}}, 'additionalProperties': False}
get_campaign_results
Campaign results
The answers, once the privacy threshold is met (open link: 5 answers; targeted: minPercent of the list). Below it the count and what is still needed. Each transcript is anonymous by construction — no field links an answer to a person. Includes the AI report if analyze_campaign has run. Answers are deleted 30 days after the campaign closes (dataDeletesAt).
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'campaignId'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'campaignId': {'type': 'integer', 'description': 'A campaign id from launch_campaign or list_my_campaigns', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
get_ledger
Ledger
Every movement of money on the account, newest first: top-ups, each campaign's price (set aside and charged at launch), refunds. The balance after each row.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey'], 'properties': {'limit': {'type': 'integer', 'maximum': 200, 'minimum': 1, 'description': 'Rows to return, default 100'}, 'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
get_login_nonce
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). First step of dashboard authentication. Returns a nonce and a message string that you must sign with your Solana wallet. The signed message is then passed to verify_login_signature to receive a session token. Nonces expire after 5 minutes.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['walletAddress'], 'properties': {'walletAddress': {'type': 'string', 'description': 'Your Solana wallet public key (base58)'}}, 'additionalProperties': False}
get_pricing
Price list
The price list as data: a flat price per campaign by size (open link: 10/50/100/200 answers; targeted: 10–200 people), charged from your prepaid balance in full when a campaign launches, whatever it receives. Also the fee on crypto rewards and how unclaimed rewards are returned. Also the top-up rules and how the sandbox works. Public — no key needed. Call this first.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
get_session_nonce
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). First step of creating a campaign session. Returns the exact message you must sign with your Solana wallet, and the nonce inside it. Pass the message and your base58 signature to initialize_session. Nonces expire after 5 minutes, and a message signed for the dashboard will not work here.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['walletAddress'], 'properties': {'walletAddress': {'type': 'string', 'description': 'Your Solana wallet public key (base58)'}}, 'additionalProperties': False}
initialize_session
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). Creates a new agent session, proving the wallet with a signature from get_session_nonce. Returns a sessionId and paymentRequired. While sessions are free (paymentRequired false), the response also carries the one-time accessToken for create_campaign, and no payment step follows. If paymentRequired is true, send the stated USDC amount to the treasury address on-chain, then call verify_payment with the transaction signature to receive the access token. The wallet you prove here becomes the campaign's creator, and is the only wallet that will be able to read its results from the dashboard.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['walletAddress', 'signature', 'message'], 'properties': {'message': {'type': 'string', 'description': 'Exact message string returned by get_session_nonce (must match byte for byte)'}, 'signature': {'type': 'string', 'description': 'Base58-encoded Ed25519 signature of the message returned by get_session_nonce'}, 'walletAddress': {'type': 'string', 'description': 'Your Solana wallet public key (base58)'}}, 'additionalProperties': False}
launch_campaign
Launch a campaign
Creates the campaign and makes it live at once, charging its flat price from your balance (quote_campaign tells you the price). open_link returns shareUrl — the link to put in front of the people you want to hear from; it closes at responseCap or on expiry. targeted sends one invitation per address in cohortEmails from clearvoyance.ai (a sandbox account gets inviteLinks back instead and nothing is emailed). The flat price for the campaign's size is charged from your balance in full at launch, whatever it receives; it is not refunded for fewer answers. Refused with INSUFFICIENT_BALANCE (shortfallCents) if the balance does not cover the tier, or INVALID_CAMPAIGN (problems[]) if the quote would fail.
可访问外部资源
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'kind', 'title', 'description', 'questions'], 'properties': {'kind': {'enum': ['open_link', 'targeted'], 'type': 'string', 'description': 'open_link: a share link anyone can answer, closing at responseCap â\x80\x94 put it in your own post-purchase email. targeted: we email one invitation per address in cohortEmails.'}, 'title': {'type': 'string', 'description': "Shown to participants, e.g. 'How was your order?'"}, 'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'giftText': {'type': 'string', 'maxLength': 500, 'description': 'Shown to a participant after answering: a promo code, a thank-you, a link. Optional.'}, 'questions': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': '1â\x80\x9310 questions participants answer by voice or text. No links or phone numbers.'}, 'minPercent': {'type': 'integer', 'description': 'targeted only: results unlock once this share of the list has answered. Floored at 50.'}, 'senderName': {'type': 'string', 'description': 'Who is asking, as participants see it (your shop or product name). Required for open_link.'}, 'description': {'type': 'string', 'description': 'What you want to learn. Steers the AI analysis; participants do not see it.'}, 'responseCap': {'type': 'integer', 'description': 'open_link only: 10, 50, 100 or 200 â\x80\x94 the link closes at that many answers. Sets the tier: $4.99 / $17.99 / $29.99 / $49.99.'}, 'cohortEmails': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 500, 'description': 'targeted only: the addresses to invite (10â\x80\x93200). Duplicates are folded. The list is discarded once every invitation is queued; only hashes are kept.'}, 'expiresInDays': {'type': 'integer', 'description': '1â\x80\x9342. Default 14 for open_link, 7 for targeted.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
list_campaigns
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). (list_my_campaigns is its equivalent for the key flow.) Lists all campaigns created by your wallet. Requires the sessionToken from verify_login_signature. Returns campaign IDs, titles, statuses, cohort sizes, and data expiry dates.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionToken'], 'properties': {'sessionToken': {'type': 'string', 'description': 'Session token from verify_login_signature'}}, 'additionalProperties': False}
list_my_campaigns
List campaigns
Every campaign on this account with its status, answers so far, the share link (open link), and what it has cost so far.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey'], 'properties': {'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
quote_campaign
Quote a campaign
Checks a campaign BEFORE launching it, for free: every problem at once (not just the first), any adjustments we would make, the flat price that launching would charge, and whether your balance covers it (and by how much it is short). For targeted campaigns pass cohortSize (the number of people), never the addresses. Always quote before launch_campaign.
只读 幂等
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['apiKey', 'kind', 'title', 'description', 'questions'], 'properties': {'kind': {'enum': ['open_link', 'targeted'], 'type': 'string', 'description': 'open_link: a share link anyone can answer, closing at responseCap â\x80\x94 put it in your own post-purchase email. targeted: we email one invitation per address in cohortEmails.'}, 'title': {'type': 'string', 'description': "Shown to participants, e.g. 'How was your order?'"}, 'apiKey': {'type': 'string', 'description': 'Your Clearvoyance API key (cv_live_â\x80¦ or cv_test_â\x80¦), from create_account'}, 'giftText': {'type': 'string', 'maxLength': 500, 'description': 'Shown to a participant after answering: a promo code, a thank-you, a link. Optional.'}, 'questions': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 10, 'minItems': 1, 'description': '1â\x80\x9310 questions participants answer by voice or text. No links or phone numbers.'}, 'cohortSize': {'type': 'integer', 'description': 'targeted only: how many people you will invite (10â\x80\x93200). The number, not the addresses.'}, 'minPercent': {'type': 'integer', 'description': 'targeted only: results unlock once this share of the list has answered. Floored at 50.'}, 'senderName': {'type': 'string', 'description': 'Who is asking, as participants see it (your shop or product name). Required for open_link.'}, 'description': {'type': 'string', 'description': 'What you want to learn. Steers the AI analysis; participants do not see it.'}, 'responseCap': {'type': 'integer', 'description': 'open_link only: 10, 50, 100 or 200 â\x80\x94 the link closes at that many answers. Sets the tier: $4.99 / $17.99 / $29.99 / $49.99.'}, 'expiresInDays': {'type': 'integer', 'description': '1â\x80\x9342. Default 14 for open_link, 7 for targeted.'}}, 'additionalProperties': False}
输出模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['ok'], 'properties': {'ok': {'type': 'boolean'}}, 'additionalProperties': True}
validate_campaign
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). (quote_campaign is its equivalent for the key flow.) Checks a campaign BEFORE you pay for anything. Free, and needs no session or access token. Returns whether it is valid, every problem at once (not just the first), any adjustments we would make (expiry clamped, privacy threshold raised, empty questions dropped), and what it will cost — the escrow total including protocol fee for incentivized campaigns, or the activation fee for no-reward ones. Call this first, fix anything it reports, and only then call get_session_nonce and pay. Pass the cohort SIZE, not the addresses: this endpoint never receives contact details.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'title': {'type': 'string', 'description': 'Campaign title, shown to participants'}, 'questions': {'type': 'array', 'items': {'type': 'object', 'properties': {'text': {'type': 'string'}}, 'additionalProperties': False}, 'description': '1-10 questions with non-empty text'}, 'cohortSize': {'type': 'number', 'description': 'How many participants â\x80\x94 the number, not the email addresses'}, 'minPercent': {'type': 'number', 'description': 'Privacy threshold; floored at 50'}, 'rewardMint': {'type': 'string', 'description': 'SPL token mint for the reward; defaults to USDC'}, 'rewardMode': {'enum': ['INCENTIVIZED', 'NO_REWARD'], 'type': 'string', 'description': 'Defaults to INCENTIVIZED'}, 'description': {'type': 'string', 'description': 'What you want to learn'}, 'expiresInDays': {'type': 'number', 'description': '1-42, default 7'}, 'incentiveCents': {'type': 'number', 'description': 'Reward per participant in cents (incentivized campaigns)'}}, 'additionalProperties': False}
verify_campaign_activation
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). For NO_REWARD campaigns only. After you have paid the flat USDC activation fee (returned in activationRequired by create_campaign), call this with the payment transaction signature to launch the campaign LIVE. Invite emails are sent to all cohort participants automatically. This call is idempotent — safe to retry.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaignId', 'txSignature', 'walletAddress'], 'properties': {'campaignId': {'type': 'integer', 'description': 'Campaign ID from create_campaign'}, 'txSignature': {'type': 'string', 'description': 'Solana transaction signature of your USDC activation fee payment to treasury'}, 'walletAddress': {'type': 'string', 'description': 'Your Solana wallet public key (must match the campaign creator)'}}, 'additionalProperties': False}
verify_campaign_funding
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). For INCENTIVIZED campaigns only. After you have funded the escrow wallet returned by create_campaign, call this with the funding transaction signature to launch the campaign LIVE. Invite emails are sent to all cohort participants automatically. This call is idempotent — safe to retry if you are unsure whether it succeeded.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['campaignId', 'txSignature', 'walletAddress'], 'properties': {'campaignId': {'type': 'integer', 'description': 'Campaign ID from create_campaign'}, 'txSignature': {'type': 'string', 'description': 'Solana transaction signature of your USDC transfer to the escrow address'}, 'walletAddress': {'type': 'string', 'description': 'Your Solana wallet public key (must match the campaign creator)'}}, 'additionalProperties': False}
verify_login_signature
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). Second step of dashboard authentication. Verifies your wallet signature against the nonce message from get_login_nonce. Returns a sessionToken (valid 24 hours) and your campaign list. Pass the sessionToken to list_campaigns, get_campaign_details, and export_campaign_data.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['walletAddress', 'signature', 'message'], 'properties': {'message': {'type': 'string', 'description': 'Exact message string returned by get_login_nonce (must match exactly)'}, 'signature': {'type': 'string', 'description': 'Base58-encoded Ed25519 signature of the message returned by get_login_nonce'}, 'walletAddress': {'type': 'string', 'description': 'Your Solana wallet public key (base58)'}}, 'additionalProperties': False}
verify_payment
LEGACY wallet flow — new integrations should use create_account and launch_campaign (API key + prepaid balance, no wallet). Only when initialize_session returned paymentRequired true: verifies your on-chain USDC payment to the treasury and returns a one-time access token. A free session needs no payment and is refused here. The access token is required for create_campaign and expires after 1 hour. The token is single-use — it is consumed when create_campaign is called.
输入模式
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['sessionId', 'txSignature'], 'properties': {'sessionId': {'type': 'integer', 'description': 'Session ID returned by initialize_session'}, 'txSignature': {'type': 'string', 'description': 'Solana transaction signature of your USDC payment to treasury'}}, 'additionalProperties': False}
已更改
create_campaign
2026年9月30日 02:40
已更改
verify_payment
2026年9月30日 02:40
已更改
initialize_session
2026年9月30日 02:40
已更改
get_agent_config
2026年9月30日 02:40
已添加
export_campaign_data
2026年9月28日 02:40
已添加
get_campaign_details
2026年9月28日 02:40
已添加
list_campaigns
2026年9月28日 02:40
已添加
verify_login_signature
2026年9月28日 02:40
已添加
get_login_nonce
2026年9月28日 02:40
已添加
verify_campaign_activation
2026年9月28日 02:40
已添加
verify_campaign_funding
2026年9月28日 02:40
已添加
create_campaign
2026年9月28日 02:40
已添加
validate_campaign
2026年9月28日 02:40
已添加
verify_payment
2026年9月28日 02:40
已添加
initialize_session
2026年9月28日 02:40
已添加
get_session_nonce
2026年9月28日 02:40
已添加
get_agent_config
2026年9月28日 02:40
已添加
close_account
2026年9月28日 02:40
已添加
close_campaign
2026年9月28日 02:40
已添加
analyze_campaign
2026年9月28日 02:40
已添加
get_campaign_results
2026年9月28日 02:40
已添加
get_campaign
2026年9月28日 02:40
已添加
list_my_campaigns
2026年9月28日 02:40
已添加
launch_campaign
2026年9月28日 02:40
已添加
quote_campaign
2026年9月28日 02:40
已添加
check_topup
2026年9月28日 02:40
已添加
create_card_topup
2026年9月28日 02:40
已添加
get_ledger
2026年9月28日 02:40
已添加
get_account
2026年9月28日 02:40
已添加
create_account
2026年9月28日 02:40