# Quickstart

> Send your first AI interaction to Voxmith

Use this page to get one tool invocation or AI interaction visible in the [Voxmith dashboard](https://app.voxmith.com). The Voxmith skill detects the right integration route and applies the smallest matching change.

## 1. Get your organization ID

1. Sign in at [app.voxmith.com](https://app.voxmith.com).
2. Open **Settings > Organization**. Copy your organization ID: it's a UUID.

In these docs, `org_id` and `VOXMITH_ORG_ID` both mean your organization ID. It
routes telemetry to your workspace but does not grant dashboard read access.

<a id="2-pick-a-path" />

## 2. Set up your application

Install the skill in your agent environment:

```bash theme={null}
npx skills add Voxmith/skills --skill voxmith
```

Then ask your coding agent to use it from your app root:

```text theme={null}
Use the voxmith skill to add Voxmith analytics.
Org ID: your-org-id
Target app: .
Verification: local app
Entrypoint: the real chat route, agent call, MCP server startup, or tool call
```

The skill asks for missing facts, detects whether your app needs SDK, MCP, or
OpenTelemetry instrumentation, and verifies the resulting setup.

After the edit, restart or deploy your app, trigger one real chat, agent action, or MCP tool call, then confirm the event in the dashboard.

***

## Setup guides

Continue in the **Get started** sidebar and select the framework or application type
you already use. Each AI framework guide keeps all three approaches together:

* **Voxmith skill** — recommended; it inspects, instruments, and verifies your app.
* **Voxmith SDK** — manually wrap the framework call you want to analyze.
* **OpenTelemetry** — connect existing framework telemetry to Voxmith.

Use one approach for a given call path at first. Enabling the SDK and OpenTelemetry
around the same call can create duplicate interactions.

<CardGroup cols={2}>
  <Card title="Agent frameworks" icon="message" href="/openai">
    Set up Voxmith for Agno, Anthropic, CrewAI, DSPy, LangChain, Mastra, OpenAI, and more.
  </Card>

  <Card title="Custom applications" icon="code" href="/python-conversation">
    Track custom Python or TypeScript AI interactions, or connect an existing OTel pipeline.
  </Card>

  <Card title="MCP servers" icon="wrench" href="/mcp-overview">
    Track tool, resource, and prompt calls from a dedicated MCP server.
  </Card>

  <Card title="Platforms" icon="database" href="/mcp-toolbox">
    Set up MCP Toolbox or Apify telemetry.
  </Card>
</CardGroup>

***

## Verify

Open [app.voxmith.com](https://app.voxmith.com) and check:

* **Conversations** for SDK-tracked interactions
* **Tool calls** for MCP tool invocations
* **Events** for the unfiltered event stream

Events usually appear within a few seconds. Nothing showing up? Check the org ID, restart/deploy state, and whether the real app path was exercised.

## Next steps

* [Conversations](/using-conversations): review the complete interaction you sent.
* [Events](/using-events): inspect the underlying telemetry and verify its fields.
* [Intents](/using-intents): organize production conversations by what users wanted.