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.
Claude (connectors)
- Open Settings → Connectors → Add custom connector (Claude.ai Pro/Max/Team/Enterprise, or Claude Desktop).
- Paste the MCP URL below. No auth, no API key.
- Claude discovers the three tools and can start a diagnostic for a founder mid-conversation.
https://solutions.ventureinsights.com.sa/api/mcpChatGPT (custom GPT with an Action)
- In ChatGPT, create a GPT → Configure → Actions → Import from URL.
- Paste the OpenAPI URL: https://solutions.ventureinsights.com.sa/api/agent/v1/openapi.json (Authentication: None).
- Add a short instruction telling the GPT to read prices live from the listServices action and to tell the founder to confirm by email. Publish, and anyone using that GPT can start a VI diagnostic.
Consumer ChatGPT can't add an MCP server inside a normal chat; the custom-GPT Action is the supported path, and it reuses this exact OpenAPI spec.
Any API-based agent
- Call the three REST routes directly, or point an MCP-capable client (ChatGPT Developer-Mode connector, an SDK agent, a framework tool) at the same endpoints below.
- The OpenAPI 3.1 spec generates a typed client in one step.
Set up the ChatGPT GPT (5 minutes, no backend)
- ChatGPT → My GPTs → Create a GPT → Configure. Name it “VI Venture Diagnostic”.
- Actions → Create new action → Authentication: None → Import from URL, and paste the OpenAPI URL below.
- Paste the instructions block below into the GPT's Instructions, then publish.
Action schema URL
https://solutions.ventureinsights.com.sa/api/agent/v1/openapi.jsonGPT instructions
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, and the venture concept in at least 50 characters (what it is, who it's for, where). Optionally sector and city. Do NOT invent these; ask.
2. Call requestDiagnostic with founder_name, founder_email, idea, optional sector/city, 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: VI has emailed the founder a one-click confirmation link (valid 7 days). Tell them to check their inbox and spam and click it; the study starts only after that click.
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. When status is "ready", share the report link the action returns.
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.
- If the action reports an existing client, a rate limit, or capacity, relay that message 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.Using Claude instead? Skip all of this and add the MCP endpoint directly in Settings → Connectors: https://solutions.ventureinsights.com.sa/api/mcp.
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.
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.
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).
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.
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, three tools.
describe_servicesThe live service catalogue: the free Concept Diagnostic plus every paid tier with current SAR pricing. Read prices here; never hardcode them.
start_free_diagnosticRegisters a pending intake and emails the founder a one-click confirmation link. Never generates anything by itself, never charges anyone.
check_diagnostic_statusPolls 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/servicesLive service catalogue and SAR prices (JSON).
POST /api/agent/v1/diagnosticStart an intake: founder_name, founder_email, idea (50–800 chars), sector, geography. Returns 202 with an intake_id and a read-only status_token.
GET /api/agent/v1/diagnostic/{id}/status?t={status_token}Poll intake progress. Every 30–60 seconds is plenty.
GET /api/agent/v1/openapi.jsonThe 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.
Paid tiers are bought by humans, on the platform
The free diagnostic's verdict tells the founder whether the concept deserves paid depth and which tier fits. Agents can quote the live catalogue from /api/agent/v1/services, but the purchase itself is always made by the founder on the VI platform; an agent can recommend, never buy.