REST API

Programmatic access to IdeaPulley's startup tools. Generate ideas, validate concepts, and stress-test business models via simple REST endpoints.

Quick Start

1Sign in at ideapulley.com/login and navigate to API Keys from the dashboard.
2Click "Generate API Key" and copy it (shown once only)
3Include it in requests: Authorization: Bearer ip_live_...

Base URL

https://ideapulley.com/api/v1

Authentication

All requests require a Bearer token in the Authorization header. Keys start with ip_live_.

Header

Authorization: Bearer ip_live_a1b2c3d4e5f6...

Endpoints

POST/ideas/generate

Generate 9 unique startup ideas for a given topic or domain. Supports multiple idea types: SaaS, mobile apps, ecommerce, AI tools, hardware, and more.

Request Body:

JSON

{
  "content": "AI-powered fitness coaching",
  "ideaType": "saas"
}

POST/ideas/validate

Validate a startup idea across 10 categories: problem, solution, market size, timing, competition, business model, defensibility, team, pricing, and unfair advantage.

Request Body:

JSON

{
  "ideaTitle": "AI Fitness Coach",
  "ideaDescription": "An AI-powered personal trainer that creates adaptive workout plans based on real-time form analysis via phone camera."
}

POST/ideas/stress-test

Run a Devil's Advocate analysis on your idea — market timing, competitor threats, unit economics, execution risks, and founder-specific risks.

Request Body:

JSON

{
  "idea": "AI-powered personal trainer that uses phone camera for real-time form correction and adaptive programming."
}

GET/usage

Check your current credit balance, plan, and usage for this billing cycle. No credit cost.

MCP Server

New

IdeaPulley ships a Model Context Protocol server so any MCP-compatible AI client — Claude Desktop, Cursor, or your own agent — can call every tool included in your plandirectly. The tools exposed are scoped to your subscription, so an AI connected to your account can ideate, validate, research, and plan exactly as you can in-app. The same catalog powers IdeaPulley's built-in /dashboard assistant.

Endpoint

POST https://ideapulley.com/api/mcp
Authorization: Bearer ip_live_your_key_here
Content-Type: application/json

Transport: Streamable HTTP. Protocol: JSON-RPC 2.0. Supported methods:initialize,tools/list,tools/call,ping. Each tools/call consumes one credit.

Connect a client (e.g. Claude Desktop / Cursor)

mcp.json

{
  "mcpServers": {
    "ideapulley": {
      "url": "https://ideapulley.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ip_live_your_key_here"
      }
    }
  }
}

List your plan's tools

tools/list

curl -X POST https://ideapulley.com/api/mcp \
  -H "Authorization: Bearer ip_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

Call a tool

tools/call

curl -X POST https://ideapulley.com/api/mcp \
  -H "Authorization: Bearer ip_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "validateIdea",
      "arguments": {
        "ideaTitle": "AI Fitness Coach",
        "ideaDescription": "AI personal trainer with real-time form analysis."
      }
    }
  }'

Rate Limits

Plan	Requests/minute	Credits/month
Starter	10	500
Growth	60	5,000
Scale	300	50,000

Error Responses

401Invalid or missing API key

402Out of credits — upgrade plan or wait for monthly reset

429Rate limit exceeded — retry after the Retry-After header

500Internal error — retry with exponential backoff

Examples

Generate Ideas

curl -X POST https://ideapulley.com/api/v1/ideas/generate \
  -H "Authorization: Bearer ip_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "AI-powered project management for remote teams",
    "ideaType": "saas"
  }'

JavaScript Example

JavaScript

const response = await fetch("https://ideapulley.com/api/v1/ideas/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ip_live_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "AI-powered project management",
    ideaType: "saas",
  }),
});

const { ideas, meta } = await response.json();
console.log(ideas);  // Array of 9 startup ideas
console.log(meta.creditsRemaining);  // Credits left this month

Support

Questions? Email support@ideapulley.com or visit the dashboard to manage your API keys.

REST API

Programmatic access to IdeaPulley's startup tools. Generate ideas, validate concepts, and stress-test business models via simple REST endpoints.

Quick Start

1Sign in at ideapulley.com/login and navigate to API Keys from the dashboard.
2Click "Generate API Key" and copy it (shown once only)
3Include it in requests: Authorization: Bearer ip_live_...

Base URL

https://ideapulley.com/api/v1

Authentication

All requests require a Bearer token in the Authorization header. Keys start with ip_live_.

Header

Authorization: Bearer ip_live_a1b2c3d4e5f6...

Endpoints

POST/ideas/generate

Generate 9 unique startup ideas for a given topic or domain. Supports multiple idea types: SaaS, mobile apps, ecommerce, AI tools, hardware, and more.

Request Body:

JSON

{
  "content": "AI-powered fitness coaching",
  "ideaType": "saas"
}

POST/ideas/validate

Validate a startup idea across 10 categories: problem, solution, market size, timing, competition, business model, defensibility, team, pricing, and unfair advantage.

Request Body:

JSON

{
  "ideaTitle": "AI Fitness Coach",
  "ideaDescription": "An AI-powered personal trainer that creates adaptive workout plans based on real-time form analysis via phone camera."
}

POST/ideas/stress-test

Run a Devil's Advocate analysis on your idea — market timing, competitor threats, unit economics, execution risks, and founder-specific risks.

Request Body:

JSON

{
  "idea": "AI-powered personal trainer that uses phone camera for real-time form correction and adaptive programming."
}

GET/usage

Check your current credit balance, plan, and usage for this billing cycle. No credit cost.

MCP Server

New

Endpoint

POST https://ideapulley.com/api/mcp
Authorization: Bearer ip_live_your_key_here
Content-Type: application/json

Transport: Streamable HTTP. Protocol: JSON-RPC 2.0. Supported methods:initialize,tools/list,tools/call,ping. Each tools/call consumes one credit.

Connect a client (e.g. Claude Desktop / Cursor)

mcp.json

{
  "mcpServers": {
    "ideapulley": {
      "url": "https://ideapulley.com/api/mcp",
      "headers": {
        "Authorization": "Bearer ip_live_your_key_here"
      }
    }
  }
}

List your plan's tools

tools/list

curl -X POST https://ideapulley.com/api/mcp \
  -H "Authorization: Bearer ip_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "jsonrpc": "2.0", "id": 1, "method": "tools/list" }'

Call a tool

tools/call

curl -X POST https://ideapulley.com/api/mcp \
  -H "Authorization: Bearer ip_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "validateIdea",
      "arguments": {
        "ideaTitle": "AI Fitness Coach",
        "ideaDescription": "AI personal trainer with real-time form analysis."
      }
    }
  }'

Rate Limits

Plan	Requests/minute	Credits/month
Starter	10	500
Growth	60	5,000
Scale	300	50,000

Error Responses

401Invalid or missing API key

402Out of credits — upgrade plan or wait for monthly reset

429Rate limit exceeded — retry after the Retry-After header

500Internal error — retry with exponential backoff

Examples

Generate Ideas

curl -X POST https://ideapulley.com/api/v1/ideas/generate \
  -H "Authorization: Bearer ip_live_your_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "content": "AI-powered project management for remote teams",
    "ideaType": "saas"
  }'

JavaScript Example

JavaScript

const response = await fetch("https://ideapulley.com/api/v1/ideas/generate", {
  method: "POST",
  headers: {
    "Authorization": "Bearer ip_live_your_key_here",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    content: "AI-powered project management",
    ideaType: "saas",
  }),
});

const { ideas, meta } = await response.json();
console.log(ideas);  // Array of 9 startup ideas
console.log(meta.creditsRemaining);  // Credits left this month

Support

Questions? Email support@ideapulley.com or visit the dashboard to manage your API keys.