CrewHaus API

Submit startup validation requests, get personalized recommendations, check capacity, and manage affiliate referrals — programmatically.

Base URL

https://crewhaus.ai/api/v1

🤖 Agent Discovery

CrewHaus supports A2A Protocol, MCP, and direct API access.

Agent Card (A2A)

GET /.well-known/agent-card.json

MCP Server (npm)

npx crewhaus-mcp-server

6 tools: get_services, get_recommendation, check_capacity, validate_idea, register_affiliate, check_affiliate_stats

GET /services

List all services, pricing, and affiliate terms. Add ?agent=true for the full sales toolkit (pitches, objection handlers, comparison data).

# Basic catalog
curl https://crewhaus.ai/api/v1/services

# Full sales toolkit for agents
curl https://crewhaus.ai/api/v1/services?agent=true

The ?agent=true response includes per-tier: whyBuy, comparedTo (price anchors), objectionHandlers, suggestedPitch, riskReversal, plus salesGuidance with when/how to recommend.

POST /recommend

Send user context, get a personalized tier recommendation with a ready-to-use pitch. Ideal for agents that want to recommend the right service.

curl -X POST https://crewhaus.ai/api/v1/recommend \
  -H "Content-Type: application/json" \
  -d '{
    "userContext": "I have an idea for a pet food delivery app",
    "hasIdea": true,
    "stage": "has-idea"
  }'

Returns: recommended tier, suggested pitch, whyBuy points, objection handlers, comparison anchors, social proof, and submit instructions.

GET /capacity

Real-time processing availability. Genuine capacity limits, not artificial scarcity.

curl https://crewhaus.ai/api/v1/capacity

Returns: status (available/limited/at-capacity), daily and weekly remaining slots, and a human-friendly message.

POST /submit

Submit a startup idea for validation. Returns an order ID and Stripe payment link.

curl -X POST https://crewhaus.ai/api/v1/submit \
  -H "Content-Type: application/json" \
  -d '{
    "tier": "signal",
    "customer": {
      "name": "Jane Smith",
      "email": "jane@example.com"
    },
    "idea": {
      "description": "AI-powered meal planning for busy parents",
      "audience": "Working parents aged 25-45"
    },
    "affiliate": {
      "code": "CH-abc123"
    }
  }'

Request Body

Field	Type	Required
tier	signal \| scan \| spec \| sprint	✅
customer.name	string	✅
customer.email	string	✅
idea.description	string	✅
idea.audience	string	—
idea.url	string	—
affiliate.code	string	— (for commission)

💰 Affiliate Program

Earn 25% commission on every order you refer — human or AI agent.

POST /affiliate/register

curl -X POST https://crewhaus.ai/api/v1/affiliate/register \
  -H "Content-Type: application/json" \
  -d '{
    "name": "My AI Agent",
    "email": "operator@example.com",
    "type": "agent"
  }'

GET /affiliate/stats

# Check your stats by code or email
curl https://crewhaus.ai/api/v1/affiliate/stats?code=CH-abc123

Returns: referral counts, conversion rate, total/pending/paid earnings, and recent referral history.

Commission

25%

Per Signal Check

$12.25

Per Scan

$24.75

Per Sprint

$199.75

How it works

Register → get your unique referral code
Include your code in affiliate.code when submitting orders
When the customer pays, your referral converts
Check earnings anytime via /affiliate/stats
Payouts at $50+ threshold, net-30

Rate Limits

POST /submit — 3 per email per hour
POST /affiliate/register — 3 per email per day
GET /services, /capacity, /affiliate/stats — No limit
POST /recommend — No limit

🔜 Coming Soon

x402 Payments — Pay in USDC directly via HTTP (Coinbase x402 protocol)
Webhook Delivery — Get results pushed to your endpoint
GET /status/:orderId — Check order progress programmatically
Stripe Connect Payouts — Automated affiliate commission payouts

Questions? Email crew@crewhaus.ai