Hosted MCP

Credits (agents)

MCP and API-key jobs use product credits (1 credit per forge / generate / ML job). Minting your first API key grants 10 credits so you can complete several agent loops immediately. The interactive web app stays free and does not spend credits. Need more during open beta? Email support@synthforge.io through August 31, 2026.

Open beta overview →

Try this prompt

After connecting MCP, ask your agent:

Use SynthForge description_to_dataset to create a multi-table ecommerce schema
(customers, orders, order_items) with foreign keys, ~200 customers, 1-4 order items
per order via relationship_counts, formats csv, then give me the Download link.

Prefer an edge table for org charts (no self-referential manager_id). Call get_credits if you hit a 402.

Endpoint

Production: https://mcp.synthforge.io/mcp

Unauthenticated calls return 401 with WWW-Authenticate: Bearer realm="synthforge-mcp". Server card: /.well-known/mcp/server-card.json.

Authentication & credits

1. Sign in at app.synthforge.io
2. Create a key under Settings → API keys (sfk_live_…)
3. Send Authorization: Bearer sfk_live_… on every MCP request

API-key / MCP traffic uses product credits (visible under Settings). Interactive web sessions do not consume credits. Full key guide: API keys & automation.

Core tools

• description_to_dataset

  North star: forge → generate → wait → download package (prefer default_rows when table names are unknown).

• forge_schema

  Natural-language description → schema only (no row generation).

• generate_dataset

  Existing schema_id + row counts → same download package.

• whoami / get_credits / get_quota

  Account identity, credit balance, and plan limits.

• wait_* / get_*_status

  Pull status or wait until terminal; progress push when the client sends progressToken.

• get_download_url / cancel_dataset

  Refresh downloads or abort an in-flight job.

Install by host

Every host needs the same two facts: URL https://mcp.synthforge.io/mcp and header Authorization: Bearer sfk_live_… (Streamable HTTP).

Cursor

Settings → MCP, then add:

{
  "mcpServers": {
    "synthforge": {
      "url": "https://mcp.synthforge.io/mcp",
      "headers": {
        "Authorization": "Bearer sfk_live_YOUR_KEY"
      }
    }
  }
}

Reload MCP and confirm tools include description_to_dataset and get_credits.

Claude Desktop / Claude Code

If the build supports remote Streamable HTTP MCP, add the same URL and Bearer header in its MCP server settings. UI labels vary by version. For hosts that only support local stdio, use another Streamable HTTP client against prod, or the monorepo stdio entry for local development.

Other agents

Any Streamable HTTP MCP client works. Discovery: server-card.json (also on mcp.synthforge.io).

Markdown twin for agents: /docs/mcp.md.