Forward MCP — get your product customers, pay per verified result

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

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