# Voxmith in Codex, Claude, and Cursor

> Integrate Voxmith and query your dashboard from Codex, Claude Desktop, Cursor, and any MCP client

Voxmith runs a hosted, OAuth-protected MCP server at **`https://mcp.voxmith.com/mcp`**. Add it to any MCP-aware client and ask natural-language questions about conversations, events, tool calls, intents, and violations.

## Connect

### Codex

```bash theme={null}
codex mcp add voxmith --url https://mcp.voxmith.com/mcp
codex mcp login voxmith
```

### Claude Desktop / Cursor

```json theme={null}
{
  "mcpServers": {
    "voxmith": {
      "url": "https://mcp.voxmith.com/mcp"
    }
  }
}
```

No API keys, no copy-pasted tokens. The first time you call a tool, the client opens a browser tab, you sign in with Google through the Voxmith dashboard, and the tab closes. First-time users automatically receive a free organization, so the integration tool can use its organization ID without asking for it.

### Other MCP clients

Anything that speaks streamable-HTTP MCP and supports OAuth 2.1 dynamic client registration works the same way. The server publishes its OAuth metadata at:

```
https://mcp.voxmith.com/.well-known/oauth-authorization-server
https://mcp.voxmith.com/.well-known/oauth-protected-resource
```

Both discovery documents advertise the supported `voxmith` OAuth scope so clients can request the server's current access level without guessing. Organization membership and permissions are still derived from the signed-in Voxmith account.

## What you can ask

* "Which tools are failing most often this week?"
* "Show me recent conversations where users had to repeat their request."
* "Show me today's violations."
* "Summarize the top intents in this org."
* "Integrate Voxmith analytics into this project."
* "Give Voxmith feedback: make exports easier to automate."

When you ask to integrate Voxmith, the MCP server returns the public Voxmith skill installation command and a project prompt containing your authenticated default organization ID. Coding clients with terminal access can run the command and continue the integration from your project root. The response ends with a link to [open the Voxmith dashboard](https://app.voxmith.com).

The feedback tool accepts anything you want to share, including something you did not like, something that felt confusing, or an idea that could make Voxmith better.

## Verify

After adding the server to your MCP client, call any Voxmith tool. The client should open a browser for OAuth the first time, then return dashboard data after login.

## Troubleshooting

* Confirm the MCP client supports streamable-HTTP MCP and OAuth 2.1 dynamic client registration.
* If OAuth does not open, remove the server from the client config and add it again.
* If a query returns no data, confirm you are logged into the right Voxmith organization in the dashboard.

## Next steps

* [Conversations](/using-conversations): understand the interaction data you can query.
* [Intents](/using-intents): learn how user goals are represented.
* [Violations](/using-violations): learn how expected behavior is evaluated.