PreTestAds

by krecicki

Not rated
GitHub

About

Score video/image ads before you spend — predicted attention benchmarked against 76 top TikTok ads; $5 USDC per run via x402, or account credits via OAuth remote server.

Details

Author
krecicki
Categories
Marketing, Security, Other

Setup

Install PreTestAds in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/krecicki/pretestads-agent-scripts

Follow the installation instructions in the repository README, then restart your MCP client.

Open-source scripts for scoring video/image ads with thePreTestAdsneural model (AdCortex™, trained on fMRI brain-response data) — fromany popular LLM platform using your own API key, or fromany x402-capable agent with a crypto wallet.

No PreTestAds account. No PreTestAds API key. Each scoring run costs$5.00 USDC, paid per-request over thex402 protocol(HTTP 402) onSolanaorBase.

POST https://pretestads.com/api/v1/score— submit a video (MP4/MOV/AVI) or image (JPG/PNG/WebP) ad by URL or file upload. You get back a job id; 5–8 minutes later,GET https://pretestads.com/api/v1/score/{id}(free) returns:

- Score 0–100(percentile vs. 76 top-performing TikTok ads) with a label: weak (<40) / moderate (40–69) / strong (70+)
- Hook Strength (first 3s), Attention Drop second, Peak Moment, Purchase Signal
- Per-second engagement timeseries

There is also a $0.50 endpoint to download any of the 76 benchmark videos:GET https://pretestads.com/api/benchmarks/{ad_id}/video.

Full agent docs:pretestads.com/api-for-ai-agents·llms.txt

Every script pays withyour wallet, signed locally: setSOLANA_PRIVATE_KEY(base58) and/orEVM_PRIVATE_KEY(0x-hex, Base). Private keys never leave your machine — they only sign the payment payload.

cd python && pip install -r requirements.txt SOLANA_PRIVATE_KEY=<base58> python score_ad.py https://example.com/ad.mp4 # or a local file: EVM_PRIVATE_KEY=0x... python score_ad.py ~/Desktop/ad.mp4
cd javascript && npm install EVM_PRIVATE_KEY=0x... node score-ad.mjs https://example.com/ad.mp4

Quickstart (LLM agent with your API key)

cd python && pip install -r requirements.txt openai OPENAI_API_KEY=sk-... SOLANA_PRIVATE_KEY=<base58> \ python openai_agent.py "Score this ad and tell me how to improve it: https://example.com/ad.mp4"

The LLM decides when to call thescore_adtool; the tool pays $5 USDC via x402, waits for the result, and hands the score back to the model to interpret.
- POST /api/v1/scorewith no payment →HTTP 402with anacceptsarray (price, USDC asset, network, payTo for Solana and Base).
- Your x402 client SDK signs a USDC payment authorization with your local key.
- Retry the POST with the payment header → server verifies + settles via the facilitator →HTTP 202with{id, status_url, payment}.
- PollGET /api/v1/score/{id}(free) untilstatusiscomplete(~5–8 min).

One payment = one run. Replayed payment proofs are rejected. Invalid media (422) is never charged.

- Solana: a wallet holding USDC and a little SOL. Export the base58 secret key.
- Base: a wallet holding USDC and a little ETH on Base. Export the 0x private key.
- Use a dedicated hot wallet with only what you intend to spend — these scripts read the key from an environment variable.

See.env.example. Never commit a real.env.

Free MCP that drives an audit of your marketing. Your AI connects, adsOS digs through your ads, email and site, and hands back a growth plan you can run today.

Remote MCP server (streamable HTTP, OAuth 2.1) for AdMake AI. Generate Facebook, Instagram and TikTok ad creatives and UGC-style video ads, research competitor ads from the Meta Ad Library, and publish finished ads to Meta via the Marketing API. Connect at https://admakeai.com/api/mcp

Multi-brand social scheduler you can drive from an AI agent — draft, see optimal times, and approve before anything posts. OAuth-connected.

Multi-brand social scheduler you can drive from an AI agent — draft, see optimal times, and approve before anything posts. OAuth-connected.

Managed TikTok/Instagram/YouTube accounts created, warmed and operated by human account managers, plus video posting at scale — 91 tools, remote OAuth or npx tokportal-mcp.

OAuth-protected MCP tools for ImagineVid image, video, and music generation across many AI capabilities, with live credit quotes and explicit approval. Learn more at https://imaginevid.io/

Data and execution layer for tokenized real-world assets (RWAs) on Injective. Open catalog tools expose indexed assets, live market data, price history, routable venues, and a 6-dimension risk score (backing, enforceability, control, exit, liquidity, social) for every asset. Trading tools (buy, sell, deposit, withdraw) work via lazy OAuth — the first trade call triggers sign-in with Realmint and a one-time wallet delegation; trades are then signed server-side under a spending cap, with no API keys or seed phrases in the client. Also supports x402 pay-per-call funding for agents.

Schedule, generate and publish social posts to X, LinkedIn, Instagram, Threads and YouTube from any MCP client.

AI ad studio for marketers and agencies: research the ads already winning in your market, generate finished on-brand image and video ads with your real product composited in, then publish them and run the campaigns across ten ad platforms — 415 tools, and unlike other marketing MCP servers it generates the creative rather than only scheduling it.

Rendley’s MCP server gives your AI client a full video editor. Connect it once, then create and edit video by describing what you want, in the same chat you already work in.

Publish short-form videos to TikTok, Instagram Reels, YouTube Shorts, X, and Facebook from AI agents through the official Taisly MCP server.

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.