← Home Pricing API Docs Launch App →
JSON-RPC API — MCP Server

Build AI agents that prospect, research,
and close
deals automatically

DealForge exposes its core capabilities via a Model Context Protocol (MCP) server. AI agents call tools to score prospects, run research, and generate personalized email drafts — paying per call with x402 pricing. No monthly subscription required.


Live API Demo

Try it right now — no signup required

Enter any company name and get an instant ICP score. This is exactly what an AI agent sees when it calls the prospect_score tool via our MCP server.

--

That's your first API result. Get an API key to use this in your own AI agent. No monthly minimum — $0.03 per prospect_score call.

Get your free API key →

MCP Server URL

Base URL
POST  https://dealforge.diy/api/v1/mcp
Authentication
X-API-Key: <your-api-key>
Example Request
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "prospect_score",
    "arguments": {
      "company_name": "Acme Corp",
      "company_industry": "SaaS",
      "company_size": "50-200 employees",
      "contact_title": "VP of Sales"
    }
  }
}
Example Response
{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{
      "type": "text",
      "text": "{\n  \\"score\\": 72,\n  \\"reasons\\": [...]\n}"
    }]
  }
}
HTTP 402 Payment Required — When a tool call fails due to insufficient credits, the response includes a topup_options array with Stripe payment links. Agents can automatically purchase credits and retry.

Available Tools

prospect_score
Score how well a company matches an ICP. Returns 0-100 score with reasoning. Use to prioritize which leads to pursue first.
Cost: $0.03 per call
prospect_research
AI research report on a company or person: company summary, pain points, talking points, buying signals.
Cost: $0.15 per call
draft_outreach
Generate a personalized cold email. Takes research_data from prospect_research for hyper-personalization. Supports professional, casual, friendly tones.
Cost: $0.20 per call
full_pipeline
Run research + score + email draft in one call. Best for quickly processing new leads end-to-end.
Cost: $0.35 per call
Rate limits are configurable per API key (default: 60 calls/minute). Set your limit when creating a key. Contact support to increase limits for high-volume workloads.

Pay per call. No monthly minimum.

Each tool call deducts credits from your API key balance. Credits never expire. No subscription required — build and pay as you go.

Tool Cost Use case
prospect_score $0.03 Score a lead against your ICP before pursuing
prospect_research $0.15 Deep research on a specific company or contact
draft_outreach $0.20 Generate a personalized cold email draft
full_pipeline $0.35 End-to-end: research + score + email draft

Buy credits. Powers all tool calls.

Credits are tied to your API key. When balance runs low, agents receive a 402 response with topup URLs built in — enabling automatic credit replenishment mid-workflow.

$10
330 credits

~$0.030 per credit

Buy pack
$25
830 credits

~$0.030 per credit — most popular

Buy pack
$100
3,300 credits

~$0.030 per credit — best value

Buy pack
Auto-topup (optional)
Enable auto-topup via PATCH /api/credits/auto-topup
Threshold: buy $10 pack when balance drops below $5

Get an API Key

Step 1

Create your key

POST your email and a label to /api/v1/mcp/keys. Requires a DealForge user account.

Step 2

Store securely

The raw key is shown once only. Store it in your agent's environment variables immediately.

Request — POST /api/v1/mcp/keys
curl -X POST https://dealforge.diy/api/v1/mcp/keys \\
  -H "Content-Type: application/json" \\
  -H "x-user-email: your@email.com" \\
  -d '{"label": "my-sales-agent", "rate_limit_per_minute": 60}'
Response
{
  "id": 42,
  "key_prefix": "a3f2b1c9...",
  "full_key": "a3f2b1c9d4e5f678...long-hex-string...",  // shown once, store it now
  "label": "my-sales-agent",
  "rate_limit_per_minute": 60,
  "warning": "Store this key securely. It will not be shown again."
}

Try it now

Enter your DealForge account email to generate an API key. You must have an active account.

Must match your DealForge account email
Descriptive name to help you track keys

Register programmatically — no account required

AI agents can self-register via POST without needing a DealForge user account. Zero-human onboarding — get an API key instantly.

Request — POST /api/v1/mcp/agents/register
curl -X POST https://dealforge.diy/api/v1/mcp/agents/register \
  -H "Content-Type: application/json" \
  -d '{"name": "my-sales-agent", "email": "agent@mycompany.com"}'
Response
{
  "api_key": "a3f2b1c9d4e5...",
  "credit_balance": 0,
  "pricing": { "prospect_score": 3, "prospect_research": 15, "draft_outreach": 20, "full_pipeline": 35 },
  "topup_urls": [...],
  "mcp_endpoint": "https://dealforge.diy/api/v1/mcp",
  "rate_limits": { "requests_per_minute": 60 }
}
Rate limit: 5 registrations per IP per hour. Balance starts at 0 — buy credits via topup_urls before calling MCP tools.
Optional: webhook_url for credit alerts
{
  "name": "my-agent",
  "email": "agent@company.com",
  "webhook_url": "https://my-agent.company.com/webhook/credits"
}