AdVouch
AdVouch provides a native FastMCP server, allowing AI models like ChatGPT (GPT-4o),Claude, Cursor, and custom LLM agents to safely interact with campaigns, retrieve verified context, and draft marketing workflows.
Because MCP is an open standard, you can connect the world's leading AI models—including ChatGPT (OpenAI) and Claude (Anthropic)—using standard configurations.
Connect ChatGPT through any MCP client (such as Cursor with GPT-4o selected, LibreChat, or the OpenAI Agents SDK) by pointing to our streamable SSE endpoint:
{
"mcpServers": {
"advouch": {
"url": "https://api.advouch.com/mcp/sse",
"model": "gpt-4o"
}
}
}You can also import AdVouch directly into Python using OpenAI function calling or the Agents SDK.
Add the following block to your Claude Desktop config located at ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%/Claude/claude_desktop_config.json (Windows):
{
"mcpServers": {
"advouch": {
"command": "python",
"args": ["-m", "mcp_server", "--transport", "stdio"],
"env": {
"DJANGO_API_URL": "https://api.advouch.com/api/v1",
"ADVOUCH_AUTH_TOKEN": "YOUR_PERSONAL_API_TOKEN"
}
}
}
}For agentic IDEs like Cursor (with GPT-4o or Claude 3.5 Sonnet), add a remote MCP server via Server-Sent Events (SSE):
advouch://)Resources allow the language model to read structured marketplace state without making mutating tool calls.
| Resource URI | Description | Auth | Cache Policy |
|---|---|---|---|
| advouch://campaigns/open | Catalog of active campaigns currently open for promoter applications. | Public | Public, 30s |
| advouch://campaigns/{campaign_id} | Full campaign rules, target metrics, payout breakdown, and timeline. | Public | Public, 60s |
| advouch://businesses/{business_id} | Public business profile, verified categories, and brand bio. | Public | Public, 300s |
| advouch://businesses/me | Authenticated business profile, active campaigns, and unreleased drafts. | Bearer Token | no-store, private |
| advouch://campaigns/{campaign_id}/analytics | Live verified visit metrics, click-through rates, and task completion stats. | Owner Token | no-store, private |
| advouch://promoter/me/earnings | Settled balances and pending quality-check earnings for the promoter. | Promoter Token | no-store, private |
Tools allow AI assistants to query the marketplace, estimate budgets, and draft campaigns.
Search active campaigns by category, campaign type (Visits/Tasks/Promo), and minimum payout in ETB.
Submit an application pitch for an open campaign. Enforces rate limits and idempotency.
Retrieve personal tracking URL or QR voucher code for an accepted campaign.
Calculate required budget and fee distribution across Visits, Tasks, or Promo Codes.
Compose a multi-tier campaign structure. Generates an HMAC draft token without spending funds.
Initiates campaign start. Returns a secure web checkout URL requiring human browser authorization.
Analyzes promoter proof submissions with prompt-injection defense and anti-fraud checks.
Verifies connectivity between the FastMCP server and the AdVouch backend API.
AdVouch strictly enforces financial safety boundaries so models can never drain budgets or act without consent.
Calling draft_campaign generates an HMAC-signed proposal and a checkout link. No money moves until the business owner confirms in a logged-in browser session.
Untrusted promoter submissions are escaped with strict delimiter protections (<untrusted_content>) preventing prompt override attacks.
Authentication tokens are passed exclusively through HTTP Authorization headers. Credentials never leak into prompt context, tool parameters, or client logs.
Connect your assistant to AdVouch FastMCP server or explore our business and promoter guides.