Forward

Forward is a remote MCP server your agent uses to buy growth outcomes: qualified leads, held sales meetings, published SEO content, and verified ad conversions. You pay only for results that pass your acceptance criteria — failed verification is never billed.

Listed in the official MCP registry as xyz.getforward/forward.

Connect (one line, no signup page)

# Claude Code
claude mcp add --transport http forward https://getforward.xyz/mcp

# Codex CLI (or any stdio-only client, via the mcp-remote bridge)
codex mcp add forward -- npx -y mcp-remote https://getforward.xyz/mcp

// Cursor · Windsurf · VS Code — MCP config
{ "mcpServers": { "forward": { "type": "http", "url": "https://getforward.xyz/mcp" } } }

Then just tell your agent:

"use forward to get me 20 qualified leads — CTOs at B2B SaaS companies"

The agent calls forward_signup once → gets an API key funded with $25 free starter credits. No website visit, no human signup, no OAuth. The whole purchase (brief → quote → checkout → verified results) happens inside your editor.

Tools

Tool	What it does
forward_signup	Create an account instantly — returns api_key + $25 free credits
forward_get_catalog	Products, prices, acceptance criteria, SLAs
forward_get_quote	Free price preview (no account needed)
forward_submit_brief	Describe who you want as customers (ICP, volume, budget cap)
forward_quote	Firm quote for a brief
forward_checkout	Authorize & start delivery — prepaid credits by default, no card
forward_get_engagement	Status, spend vs. cap, results so far
forward_get_results	Verified results, each with evidence + itemized charge
forward_get_activity	Live feed of what the fleet is doing
forward_credits / forward_topup_credits	Balance / top up (x402)

Billing guarantees (machine-verifiable)

• A charge fires only after a result passes your acceptance criteria
• Itemized: one charge per result_id, with verification evidence attached
• Hard budget cap enforced server-side on every payment rail
• Idempotent (a result can never bill twice) and reversible (acceptance failure auto-refunds)
• SLA: first verified result within the window (content 3d · leads 7d · meetings/campaigns 14d) or the engagement is free

Payment rails

credits (prepaid, default — $25 free to start) · x402 (HTTP 402 + USDC, pay-per-call) · stripe_acp (delegated token with max_charge_usd)

Use Forward in your agent framework

Ready-to-paste integrations for LangChain, the Vercel AI SDK, and OpenAI/Anthropic tool calling — see examples/. Each exposes the same four tools (forward_signup, forward_get_quote, forward_buy, forward_get_results) so an agent can get customers and pay per verified result, with $25 free credits to start.

Run the stdio server locally (optional)

This repo ships a runnable zero-dependency stdio MCP server (mcp-server.js) that talks to the hosted Forward API:

node mcp-server.js            # or: docker build -t forward-mcp . && docker run -i forward-mcp

It exposes the same tools, including self-provisioning forward_signup (the minted key is remembered for the session). The remote endpoint at https://getforward.xyz/mcp is the recommended path — no install at all.

Plain HTTP / SDKs

Everything the MCP tools do is also plain REST — OpenAPI · llms.txt · docs. Zero-dependency SDK clients for TypeScript (forward.ts) and Python (forward.py) are in this repo.

from forward import Forward
fwd = Forward.start("https://getforward.xyz")   # mints a key (+ $25 free credits)
eng = fwd.get_customers({"product": "leads", "icp": {"roles": ["CTO"]},
                         "volume": 20, "budget_cap_usd": 250})
print(fwd.results(eng["engagement_id"]))

---

Forward — get customers, not software. Operated by agents, built to be bought by agents. getforward.xyz