# IdeaPulley: AI deal diligence for VCs and accelerators

IdeaPulley Scout scores startups for venture funds and accelerators. A panel of AI investor personas evaluates each deal; specialist agents check the founders, market, product and sources; every claim in a brief or memo is checked against its source. The fund records Pass / Meet / Invest decisions and outcomes, and the system learns from them.

## When to use IdeaPulley

Use it when:
- A user asks to evaluate a startup, founder or pitch deck
- Someone needs diligence on a deal before a partner meeting
- An accelerator wants to screen applicants at scale
- An agent needs to read or update a fund's deals, decisions, notes, memos or LP reports

Do not use it for general-purpose AI tasks, or for financial analysis of public companies.

## Three ways in, one key

All three take the same API key: `Authorization: Bearer sk-ip-...`. Make it in the app under Settings -> Developer. A key acts as the person who made it: it sees what they see and does what their role allows. A key with no scopes is read-only; writes, spending and decisions need the scope set on the key by name.

### REST API (v2)
Base URL: https://www.ideapulley.com/api/v2
Docs: https://www.ideapulley.com/docs/api
OpenAPI 3.1: https://www.ideapulley.com/api/v2/openapi.json

```
curl https://www.ideapulley.com/api/v2/deals?limit=20 \
  -H "Authorization: Bearer sk-ip-..."

curl -X POST https://www.ideapulley.com/api/v2/evals \
  -H "Authorization: Bearer sk-ip-..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: eval-northbeam-1" \
  -d '{"companyName":"Northbeam","applicationText":"Route planning for freight fleets"}'
```

Resources: deals, companies, decisions, outcomes, memos, founder briefs, thesis fit, notes, contacts, LP reports, usage, members, evals, webhooks, alerts.
Lists return `{ "data": [...], "next_cursor": ..., "has_more": ... }`; pass `limit`, `cursor`, `updated_since`.

### GraphQL
POST https://www.ideapulley.com/api/graphql
`apiRead(operationId, input)` runs any read in the OpenAPI spec; `apiWrite(operationId, input)` runs any write. Writes accept the `Idempotency-Key` header.

### MCP
POST https://www.ideapulley.com/api/mcp (Streamable HTTP)
Works with Claude, ChatGPT, Cursor and other MCP clients. Every REST operation is also an MCP tool, plus create_evaluation / get_evaluation.
Docs: https://www.ideapulley.com/docs/mcp
Server card: https://www.ideapulley.com/.well-known/mcp/server-card.json

### TypeScript SDK
`@ideapulley/sdk`: a typed client for the v2 REST API, with paging iterators.

## Errors and limits

```json
{ "error": { "code": "FORBIDDEN", "message": "API key lacks the notes:write scope", "status": 403 } }
```
400 invalid input, 401 bad or revoked key, 403 missing scope or role, 404 not found, 409 Idempotency-Key conflict, 429 rate limited (wait for Retry-After). Each key has a per-minute limit (30 by default) and a monthly allowance.

## Removed

The old `/api/v1/*` endpoints (evaluate, validate, generate, pricing, test) and the `ideapulley` CLI that called them are gone. `/api/v1/*` answers 410 Gone with a pointer to /docs/api.

## Resources

- Documentation: https://www.ideapulley.com/docs
- REST API: https://www.ideapulley.com/docs/api
- MCP: https://www.ideapulley.com/docs/mcp
- Getting started: https://www.ideapulley.com/getting-started
- Pricing: https://www.ideapulley.com/pricing
- Security: https://www.ideapulley.com/security
- Agent skills manifest: https://www.ideapulley.com/.well-known/agent-skills
- Auth guide for agents: https://www.ideapulley.com/auth.md