# Getting Started

> Choose how to integrate with graph8 - SDK, MCP, CLI, or REST API

Source: https://docs.graph8.com/developers/getting-started/

Welcome to the graph8 developer platform. Four ways to integrate - pick the one that fits how you build.

> **Tip: Choose your plan first**
> Before you wire up code, decide how you want to pay. **PAYG** ($0.05/credit, 1,000 free credits, no card) is best for evaluators and low-volume scripts. **Platform** ($499/mo) gives you 75,000 included AI credits *plus* unlimited graph8 index lookups within a 50 rps cap. See **[Pricing](https://docs.graph8.com/developers/pricing/)** for the full comparison.

### Install & Embed

**JavaScript SDK**

    25+ modules - tracking, visitor intelligence, AI copilot, webchat, calendar, enrichment. TypeScript. React hooks.

    `npm install @graph8/sdk` - [Full reference →](https://docs.graph8.com/developers/sdk/)

**MCP Server**

    43 tools for AI agents. Claude.ai, Claude Desktop, Cursor, VS Code, ChatGPT. Just paste the URL.

    `https://be.graph8.com/mcp/` - [Setup guide →](https://docs.graph8.com/developers/mcp/)

### Script & Automate

**CLI**

    20+ terminal commands for contacts, prospecting, enrichment, sequences, campaigns. JSON output, scriptable.

    `pip install g8-mcp-server` - [View commands →](https://docs.graph8.com/developers/cli/)

**REST API**

    300+ endpoints. Contacts, companies, lists, enrichment, search, sequences, webhooks. Any language.

    `https://be.graph8.com/api/v1` - [API overview →](https://docs.graph8.com/developers/)

---

## Which should I use?

| I'm building... | Use | Why |
|-----------------|-----|-----|
| A browser app (React, Next.js, Vue) | [JavaScript SDK](https://docs.graph8.com/developers/sdk/) | Typed, SSR-safe, React hooks, widgets |
| A server script or backend | [REST API](https://docs.graph8.com/developers/) or [CLI](https://docs.graph8.com/developers/cli/) | Direct HTTP or terminal commands |
| AI-powered workflows | [MCP Server](https://docs.graph8.com/developers/mcp/) | 43 tools, natural language |
| A quick prototype | [CLI](https://docs.graph8.com/developers/cli/) | Fastest to test, JSON output |

## Authentication

| Method | For | Where to get it |
|--------|-----|----------------|
| **Write key** | SDK (client-side) | Settings > MCP & API > tracking snippet |
| **API key** | REST API, CLI, SDK (server-side) | Settings > MCP & API > API tab |
| **OAuth** | MCP Server | Automatic - paste URL, sign in |

See [Authentication](https://docs.graph8.com/developers/authentication/) for details.

---

## Common Workflows

### Find and reach new leads

```
g8.enrich.search(filters)          // or POST /api/v1/search/contacts
  → g8.enrich.person(email)        // or POST /api/v1/enrichment/lookup/person
  → g8.sequences.add(config)       // or POST /api/v1/sequences/{id}/contacts
```

1. **Search** the 700M+ contact / 100M+ company database with filters ([SDK](https://docs.graph8.com/developers/sdk/#enrichment) | [API](https://docs.graph8.com/developers/search/) | [CLI](https://docs.graph8.com/developers/cli/#g8-find-contacts))
2. **Enrich** contacts to fill missing emails/phones ([SDK](https://docs.graph8.com/developers/sdk/#enrichment) | [API](https://docs.graph8.com/developers/enrichment/) | [CLI](https://docs.graph8.com/developers/cli/#g8-enrich))
3. **Sequence** to enroll in outreach ([SDK](https://docs.graph8.com/developers/sdk/#sequences) | [API](https://docs.graph8.com/developers/sequences/) | [CLI](https://docs.graph8.com/developers/cli/#g8-add-to-sequence))

### Embed graph8 in your product

```
g8.init({ writeKey })
g8.visitors.identify()             // Know who's visiting
g8.copilot.open()                  // AI assistant
g8.calendar.show()                 // Booking widget
g8.forms.lookup(email)             // Smart forms
```

All via the [JavaScript SDK](https://docs.graph8.com/developers/sdk/) with a write key. No API key needed.

### Automate with AI

Paste `https://be.graph8.com/mcp/` into [Claude.ai](https://docs.graph8.com/developers/mcp/), [Claude Desktop](https://docs.graph8.com/developers/mcp/), [Cursor](https://docs.graph8.com/developers/cursor-setup/), or [ChatGPT](https://docs.graph8.com/developers/mcp/). Then ask in natural language:

> "Find 10 VPs of Sales at SaaS companies with 50-200 employees, save to a list, and enrich the ones missing emails."

See [MCP Server](https://docs.graph8.com/developers/mcp/) and [What You Can Ask](https://docs.graph8.com/developers/what-you-can-ask/).

### Route data to your warehouse

```
g8.track() → Functions (transform/filter) → BigQuery / Snowflake / Postgres
```

Every event automatically routes to all connected [destinations](https://docs.graph8.com/developers/destinations/). Add BigQuery in the dashboard - every `g8.track()` call lands there. No extra code.

- [Data Pipeline overview](https://docs.graph8.com/developers/data-pipeline/) - how events flow
- [Destinations](https://docs.graph8.com/developers/destinations/) - BigQuery, Snowflake, ClickHouse, Redshift, Postgres, S3, GA4, HubSpot, Amplitude
- [Functions](https://docs.graph8.com/developers/functions/) - JavaScript transforms (filter, enrich, PII strip)
- [Live Events](https://docs.graph8.com/developers/live-events/) - real-time event debugger