# Run OpenAgent from any AI

> One hosted MCP server runs your whole front office: point Claude, Claude Code, Cursor, or your own agent at https://app.openagent.work/mcp with an API key and it can do everything the dashboard does.

Everything the dashboard does is exposed as tools on a hosted **MCP server**. Hand any MCP-capable AI an API key and it can create businesses and services, teach knowledge, build and publish workflows, buy phone numbers, complete SMS (A2P) compliance, run campaigns, manage contacts and CRM connections, and read your analytics — a whole front office, set up in one conversation.

## Connect

Create an API key under **Settings → API keys**, then add the server to your client. The endpoint speaks MCP's Streamable HTTP transport:

```text
URL:    https://app.openagent.work/mcp
Header: Authorization: Bearer bk_…
```

For Claude Code:

```bash
claude mcp add bookbag https://app.openagent.work/mcp \
  --transport http \
  --header "Authorization: Bearer bk_…"
```

For Claude Desktop or Cursor, add the same URL and header in the client's MCP settings.

> **THE KEY IS THE WORKSPACE:** Whoever holds a bk_ key can do everything the workspace owner can — projects and billing-adjacent actions included. Treat it like a password; delete it in Settings to cut access instantly.

## What's on the server

| Area | Tools |
| --- | --- |
| Businesses & services | `list_projects` · `create_project` · `create_service` · `get_analytics` |
| Knowledge | `add_knowledge` (text / Q&A / URL) · `list_knowledge` |
| Workflows | `list_workflows` · `create_workflow` · `update_workflow_graph` · `get_workflow` · `set_workflow_triggers` · `publish_workflow` · `test_workflow` |
| Phone & texting | `search_phone_numbers` · `buy_phone_number` · `list_phone_numbers` · `setup_receptionist` · `get/save/register_sms_compliance` · `assign_sms_number` |
| Outreach & people | `create_campaign` · `get_campaign` · `list_contacts` · `add_contact` |
| CRM & integrations | `get_crm` · `create_crm_api_key` · `list_integrations` · `use_integration` |

Full argument-level detail is in the [tool reference](/docs/mcp/tools); a worked end-to-end session is in [Build a business from a chat](/docs/mcp/build-a-business).

## Behavior

- **Mutations are real and immediate** — there is no draft layer at the API.
- **Errors are correctable** — a wrong business name comes back with the list of real ones, so the model fixes itself.
- **Paid actions respect your plan** — number purchases require live billing, campaigns require the outbound entitlement.
- **The same catalog powers the in-app copilot**, where every change goes through a propose-and-approve flow instead.