# graph8

> B2B sales and marketing platform with a developer SDK, REST API, MCP server, CLI, and real-time demand intelligence. graph8 provides visitor intelligence, AI copilot, webchat, calendar booking, contact enrichment (300M+ records), email sequences, campaign management, CRM integrations, and progressive forms - all accessible via a single JavaScript SDK or REST API.

## Developer Platform

- [JavaScript SDK](https://graph8.com/docs/developers/sdk): `npm install @graph8/js` - 14 modules for tracking, visitor intelligence, AI copilot, webchat, calendar, enrichment, sequences, campaigns, and more. TypeScript. React hooks. SSR-safe.
- [MCP Server](https://graph8.com/docs/developers/mcp): 43 tools for AI agents. Claude.ai, Claude Desktop, Cursor, VS Code, ChatGPT. URL: `https://be.graph8.com/mcp/`
- [CLI](https://graph8.com/docs/developers/cli): `pip install g8-mcp-server` - 20+ terminal commands for contacts, prospecting, enrichment, sequences, campaigns.
- [REST API](https://graph8.com/docs/developers): 300+ HTTP endpoints. Base URL: `https://be.graph8.com/api/v1`
- [Interactive API Docs](https://be.graph8.com/api/v1/docs): OpenAPI/Swagger spec

## SDK Quick Start

```bash
npm install @graph8/js
```

```typescript
import { g8 } from '@graph8/js';
g8.init({ writeKey: 'YOUR_WRITE_KEY' });
g8.track('signup', { plan: 'pro' });
g8.identify('user@acme.com', { name: 'John' });
```

### React / Next.js
```tsx
import { G8Provider, useG8 } from '@graph8/js/react';
<G8Provider writeKey="YOUR_KEY"><App /></G8Provider>
const { track, identify, visitors, copilot, calendar } = useG8();
```

## SDK Modules

### Client-side (write key - safe for browsers)
- `g8.track(event, properties)` - Event tracking
- `g8.identify(userId, properties)` - User identity
- `g8.page(properties)` - Page view tracking
- `g8.visitors.identify()` - IP-to-company resolution (know who's visiting)
- `g8.visitors.score()` - Engagement scoring
- `g8.visitors.onIntent(level, callback)` - Real-time intent listener
- `g8.copilot.open(config)` - Embeddable AI assistant widget
- `g8.copilot.ask(message)` - Programmatic AI chat
- `g8.chat.open(config)` - Webchat widget
- `g8.chat.send(message)` - Send chat message
- `g8.calendar.show(config)` - Booking widget (modal)
- `g8.calendar.embed(selector, config)` - Inline booking embed
- `g8.calendar.slots(user, slug, range)` - Get available time slots
- `g8.calendar.book(request)` - Book programmatically
- `g8.forms.lookup(email)` - Progressive form enrichment (skip known fields)
- `g8.signals.company(domain)` - Intent signals for a company

### Server-side (API key - never expose in browser)
- `g8.enrich.person(params)` - Person lookup from 300M+ contacts (1 credit)
- `g8.enrich.company(params)` - Company lookup (1 credit)
- `g8.enrich.verifyEmail(email)` - Email verification (1 credit)
- `g8.enrich.search(filters)` - Search contacts with filters
- `g8.sequences.list()` - List outbound sequences
- `g8.sequences.add(config)` - Add contacts to sequence
- `g8.campaigns.list()` - List campaigns
- `g8.campaigns.create(config)` - Create campaign
- `g8.campaigns.launch(id)` - Launch campaign
- `g8.campaigns.stats(id)` - Campaign analytics
- `g8.integrations.list()` - List connected CRMs
- `g8.integrations.connect(provider)` - Connect CRM (HubSpot, Salesforce, Pipedrive)
- `g8.analytics.overview(config)` - Dashboard metrics
- `g8.voice.start(config)` - AI voice call
- `g8.pages.clone(url)` - Clone landing page from URL
- `g8.pages.publish(id)` - Publish to CDN
- `g8.webhooks.on(event, callback)` - Listen for events

## Built-in CDP + Data Pipeline

graph8 includes a built-in customer data platform (ClickHouse + PostgreSQL). Every g8.track() and g8.identify() call is stored and actionable automatically - contacts, enrichment, sequences, campaigns all work out of the box. No warehouse setup required.

Optionally, route a copy of events to your own warehouse or analytics tools:

- **Destinations**: BigQuery, Snowflake, ClickHouse, Redshift, Postgres, MySQL, S3, Google Analytics 4, HubSpot, Amplitude, Mixpanel, Facebook Conversion API, webhooks
- **Functions**: JavaScript transforms that filter, transform, and enrich events in transit. APIs: fetch (HTTP), store (persistent), geo (IP geolocation), ua (user agent), getWarehouse (query warehouse)
- **Live Events**: Real-time event debugger showing payloads, function results, destination delivery
- **Auto-Schema**: Tables and columns created automatically in warehouses from event JSON
- **Replay**: Backfill historical events to newly added destinations

### Replaces
- Segment → g8.track() + Destinations
- Clearbit / ZoomInfo → g8.enrich.person() (300M+ contacts)
- Outreach / Apollo → g8.sequences.add()
- Calendly → g8.calendar.show()
- Intercom / Drift → g8.copilot.open() + g8.chat.open()
- Typeform → g8.forms.lookup()
- 6sense → g8.visitors.identify()
- HubSpot CRM → Built-in contacts, companies, lists, deals

## Authentication

| Method | For | How |
|--------|-----|-----|
| Write key | SDK client-side | `g8.init({ writeKey: '...' })` - from Settings > MCP & API |
| API key | SDK server-side, REST API, CLI | `g8.init({ apiKey: '...' })` - from Settings > MCP & API > API tab |
| OAuth | MCP Server | Paste URL, sign in - automatic |

## B2B Trends

- [Methodology](https://www.graph8.com/trends/methodology): How we collect, score, and classify B2B demand signals
- [Structured Data API](https://api.graph8.com/public/trends/data.json): Full trend dataset in JSON format (public, no auth required)

## Trend Reports

- [RAG architecture](https://www.graph8.com/trends/rag-architecture): RAG architecture B2B demand data and firmographic analysis
- [generative engine optimization](https://www.graph8.com/trends/generative-engine-optimization): generative engine optimization B2B demand data and firmographic analysis
- [dark funnel](https://www.graph8.com/trends/dark-funnel): dark funnel B2B demand data and firmographic analysis
- [agentic workflows](https://www.graph8.com/trends/agentic-workflows): agentic workflows B2B demand data and firmographic analysis
- [vibe coding](https://www.graph8.com/trends/vibe-coding): vibe coding B2B demand data and firmographic analysis
- [model context protocol](https://www.graph8.com/trends/model-context-protocol): model context protocol B2B demand data and firmographic analysis
- [AI agents](https://www.graph8.com/trends/ai-agents): AI agents B2B demand data and firmographic analysis
- [platform engineering](https://www.graph8.com/trends/platform-engineering): platform engineering B2B demand data and firmographic analysis
- [AIOps](https://www.graph8.com/trends/aiops): AIOps B2B demand data and firmographic analysis
- [GPU cloud](https://www.graph8.com/trends/gpu-cloud): GPU cloud B2B demand data and firmographic analysis
- [community-led growth](https://www.graph8.com/trends/community-led-growth): community-led growth B2B demand data and firmographic analysis
- [multimodal AI](https://www.graph8.com/trends/multimodal-ai): multimodal AI B2B demand data and firmographic analysis
- [AI guardrails](https://www.graph8.com/trends/ai-guardrails): AI guardrails B2B demand data and firmographic analysis

## Industry Categories

- [AI & Automation](https://www.graph8.com/trends/ai-automation)
- [Sales & Revenue](https://www.graph8.com/trends/sales-revenue)
- [Marketing](https://www.graph8.com/trends/marketing)
- [Manufacturing](https://www.graph8.com/trends/manufacturing)
- [Healthcare](https://www.graph8.com/trends/healthcare)
- [Financial Services](https://www.graph8.com/trends/financial-services)
- [Cybersecurity](https://www.graph8.com/trends/cybersecurity)
- [Cloud & Infrastructure](https://www.graph8.com/trends/cloud-infrastructure)
- [Energy & Sustainability](https://www.graph8.com/trends/energy-sustainability)
- [Data & Analytics](https://www.graph8.com/trends/data-analytics)

## Contact

- Website: https://www.graph8.com
- Product: https://app.graph8.com
- Developers: https://www.graph8.com/developers
- Docs: https://graph8.com/docs/developers/sdk