# Introduction

> Orwel documentation: the SDK, Dev mode, integrations, the REST API and the MCP server.

## Welcome to Orwel

Orwel is an event analytics SDK for startups, developers and vibe coders that maps feature adoption and conversion funnels, and feeds the results back to AI agents through MCP. The SDK captures visits, events and conversions; Orwel shows how people move through your journeys and features, scores every lead and ties it to the campaign that brought it. To build on top of it, use the REST API or connect an AI agent through MCP.

<CardGroup cols={2}>
  <Card title="Install the SDK" icon="code" href="/guides/frameworks">
    Next.js, SvelteKit, Astro, Vite, HTML, Shopify, WordPress, Webflow and Lovable.
  </Card>
  <Card title="Dev mode" icon="flask" href="/guides/dev-mode">
    Test with the development key and see every request live.
  </Card>
  <Card title="Integrations" icon="plug" href="/integrations/google-ads">
    Google Ads, Meta Ads and HubSpot.
  </Card>
  <Card title="MCP for agents" icon="robot" href="/agents/mcp">
    Ask Claude or Cursor about your leads and campaigns.
  </Card>
</CardGroup>

## The REST API

Access your workspace data programmatically with an API key: build integrations, automate workflows and extend Orwel.

<CardGroup cols={2}>
  <Card
    title="Quickstart"
    icon="rocket"
    href="/quickstart"
  >
    Get your API up and running in about 2 minutes
  </Card>
  <Card
    title="API Reference"
    icon="code"
    href="/api-reference/introduction"
  >
    Explore all available endpoints and their parameters
  </Card>
  <Card
    title="Authentication"
    icon="key"
    href="/authentication"
  >
    Learn how to authenticate your API requests
  </Card>
  <Card
    title="Rate Limiting"
    icon="gauge"
    href="/concepts/rate-limiting"
  >
    Understand rate limits and best practices
  </Card>
</CardGroup>

## Key Features

<AccordionGroup>
  <Accordion icon="shield" title="Workspace Isolation">
    Every API request is automatically scoped to your workspace. You can only access data that belongs to your organization, ensuring complete data isolation and security.
  </Accordion>
  
  <Accordion icon="bolt" title="Rate Limiting">
    Every API key has its own rate limit, and all responses include rate limit headers.
  </Accordion>
  
  <Accordion icon="list" title="Pagination">
    All list endpoints support pagination with customizable limit and offset parameters. Maximum of 100 items per request.
  </Accordion>
  
  <Accordion icon="filter" title="Advanced Filtering">
    Filter results by various parameters including dates, sources, and custom fields to get exactly the data you need.
  </Accordion>
</AccordionGroup>

## Base URL

All API requests should be made to:

```
https://api.orwel.io/api/v1
```

## Need Help?

<CardGroup cols={2}>
  <Card title="Support" icon="envelope" href="/support">
    Email the Orwel team
  </Card>
  <Card title="Book a session" icon="calendar" href="https://calendar.app.google/PK9jFSscVpemopQ76">
    30 minutes to review your setup
  </Card>
</CardGroup>
