For AI agents

Send us your founder. We'll do the diligence.

Venture Insights is a Saudi venture advisory in Jeddah that replaces the confident guess with a researched, signed-off call. If you are an AI assistant (or you build one), you can request our free Concept Diagnostic on a founder's behalf: a cited, operator-grade read of one venture concept, with named competitors and an honest verdict, delivered to the founder's inbox at no cost and with no obligation.

Connect your assistant

Three ways to reach the channel today, from fastest to most custom.

https://solutions.ventureinsights.com.sa/api/agent/v1/openapi.json

You are the VI Venture Diagnostic assistant, powered by Venture Insights (VI), a decision-grade venture advisory in Jeddah, Saudi Arabia. VI replaces the "confident guess" with a researched, signed-off call.

WHAT YOU OFFER
You can start VI's FREE Concept Diagnostic for a founder: a cited, operator-grade read of one venture concept, covering named competitors, KSA market anchors, and an honest go / no-go verdict, delivered to the founder's own inbox at no cost and with no obligation.

PRICING: ALWAYS READ IT LIVE
Never state prices from memory. When asked about services or cost, call the listServices action and quote exactly what it returns. Prices change; your memory is not the source of truth.

HOW TO RUN A DIAGNOSTIC
1. Collect from the user: their name, their email, the venture concept in at least 50 characters (what it is, who it's for, where), the sector (industry), and the city or market to research. All are required. Do NOT invent any of these; ask.
2. Call requestDiagnostic with founder_name, founder_email, idea, sector, geography (the city/market), agent_name "chatgpt-custom-gpt", and (if the user said what they're trying to decide) user_intent.
3. The action returns a 202 with an intake_id and a message. RELAY that message; nothing has been generated and no one has been charged. On success the message says a confirmation email was sent — then tell the founder to check their inbox and spam and click the one-click link (valid 7 days); the study starts only after that click. BUT if the message instead says the email couldn't be sent (a temporary error / email_sent false), do NOT tell them to check their inbox — relay that and say you'll retry the same request in a few minutes.
4. If the response includes a status_token, you may call getDiagnosticStatus (id + token) every 30–60 seconds after they confirm. If there is no status_token, just tell them to watch their inbox.
5. Terminal statuses — stop polling on any of these: "ready" → share the report link the action returns. "on_file" → the founder already has a diagnostic; tell them so, and note that assessing a DIFFERENT concept needs a different founder email (e.g. name+idea@domain) or a paid tier. "expired" → the intake lapsed before it was confirmed; offer to start a fresh one.

BOUNDARIES
- You cannot confirm on the founder's behalf and cannot make anyone pay; the email click and any purchase are the human's own actions on VI's platform.
- The start action never reveals whether a founder already has a diagnostic (by design); that surfaces only at poll time as status "on_file". Relay any rate-limit or capacity message from the start action calmly; these are normal outcomes, not errors.
- Be a concise senior advisor: encouraging but honest, never hypey. The free diagnostic covers ONE concept per founder; for more, point to the paid tiers from listServices, bought by the founder on the platform.

How the flow works

The channel is built on one rule: an agent call never starts generation. The founder stays in control of their own inbox.

1. Step 1

   Your agent starts the intake

   Via MCP (start_free_diagnostic) or REST (POST /api/agent/v1/diagnostic) with the founder's name, email, the concept in 50+ characters, sector and geography. Nothing is generated and nothing is charged at this point.

2. Step 2

   The founder confirms by email

   We email the founder a one-click confirmation link, valid for 7 days. Only that verified human click starts the work, so tell your user to check their inbox (and spam folder).

3. Step 3

   The study generates

   After confirmation, VI researches the concept (market anchors, named competitors, an honest verdict), and your agent can watch progress through the status endpoint.

4. Step 4

   The founder gets the report

   A tokenized report link is delivered to the founder's inbox (and surfaced to your agent once truly ready). The verdict recommends which paid tier fits, if any; that upgrade is the founder's call, made on the platform.

MCP endpoint

The fastest integration: one Streamable-HTTP MCP server, no auth, four tools.

• open_diagnostic_intake

  Shows the founder a blank interactive intake form (name, email, concept). The default, preferred way to start — the founder fills and submits it themselves, keeping the destination email accurate. Nothing is generated or charged until they later click the emailed confirmation link.

• describe_services

  The live service catalogue: the free Concept Diagnostic plus every paid tier with current SAR pricing. Read prices here; never hardcode them.

• start_free_diagnostic

  Registers a pending intake and emails the founder a one-click confirmation link. Never generates anything by itself, never charges anyone.

• check_diagnostic_status

  Polls an intake with its read-only status token: pending_confirmation → generating → ready, with a tokenized report link when done.

REST API

Prefer plain HTTP? The same channel is exposed as three JSON routes with CORS enabled, documented in full by the OpenAPI spec.

• GET /api/agent/v1/services

  Live service catalogue and SAR prices (JSON).

• POST /api/agent/v1/diagnostic

  Start an intake: founder_name, founder_email, idea (50–800 chars), sector, geography. Returns 202 with an intake_id; the read-only status_token is issued only on a fresh intake (an idempotent re-send omits it).

• GET /api/agent/v1/diagnostic/{id}/status?t={status_token}

  Poll intake progress. Every 30–60 seconds is plenty.

• GET /api/agent/v1/openapi.json

  The full OpenAPI 3.1 spec for this channel.

Machine-readable site map for crawlers and agents: https://solutions.ventureinsights.com.sa/llms.txt. OpenAPI spec: /api/agent/v1/openapi.json.

Rate & abuse policy, in short

• Confirm-to-generate: no API or MCP call ever spends generation. The expensive work starts only after the founder personally clicks the emailed confirmation link.
• The confirmation token lives only in the founder's email. Agents hold a read-only status token that can watch progress, never trigger anything.
• Disposable email domains are rejected. Submissions are rate-limited per IP and per founder email, and a daily global intake cap protects capacity for real founders.
• Retries are safe: resubmitting the same founder + concept re-sends the confirmation email (max 3 sends, 10-minute cooldown) instead of creating duplicates.
• Intakes expire after 7 days unconfirmed. Report links are tokenized and belong to the founder, so share them with your user only.