> ## Documentation Index
> Fetch the complete documentation index at: https://docs.jedify.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Modes

> Jedify MCP runs in three modes — Asker, Editor, and Builder. Same connection, different tools.

Jedify's MCP server exposes three modes. The connection and authentication are identical — the mode only changes which tools your client sees.

* **Asker** *(default)* — ask questions in plain language; get data back.
* **Editor** — have your agent propose changes to your semantic layer for human review.
* **Builder** — have your agent build data apps and dashboards using Jedify's semantic functions.

## Choose your mode

|                           | Asker mode                             | Editor mode                                              | Builder mode                                |
| ------------------------- | -------------------------------------- | -------------------------------------------------------- | ------------------------------------------- |
| **Best for**              | Ad-hoc questions and analysis          | Evolving the semantic layer itself                       | Building dashboards and data apps           |
| **How you use it**        | You ask, in conversation               | You describe a change; your agent proposes it for review | You describe; your agent builds             |
| **Speed**                 | A few seconds — generated per question | Edits await human approval                               | Instant — prebuilt, no AI at runtime        |
| **Tools your agent gets** | Questioning and analysis               | The above, plus semantic-layer editing                   | The above, plus function management and SDK |

## Asker mode

Ask a question in plain language. Jedify interprets it against your semantic layer, runs the query, and returns the data. Best for ad-hoc exploration, investigations, and reporting.

<CardGroup cols={2}>
  <Card title="Asker tools" icon="wrench" href="/mcp/asker/tools-reference">
    Every tool available in Asker mode.
  </Card>

  <Card title="Examples" icon="lightbulb" href="/mcp/asker/use-cases">
    Example prompts and what your agent does.
  </Card>
</CardGroup>

## Editor mode

Describe a change to your semantic layer — a new entity, a relationship, a dimension — and your agent proposes it as a batch of edits. Jedify validates the changes and stages them as review-pending edit sessions; nothing takes effect until a human approves them.

<CardGroup cols={2}>
  <Card title="Editor tools" icon="wrench" href="/mcp/editor/tools-reference">
    The tools your agent uses, and how an edit flows to approval.
  </Card>
</CardGroup>

## Builder mode

Describe the dashboard or app you want; your agent builds it using **semantic functions**. No coding required — see [Semantic functions](/mcp/builder/semantic-functions) for how it works.

<CardGroup cols={2}>
  <Card title="Semantic functions" icon="cube" href="/mcp/builder/semantic-functions">
    What they are and how they're created.
  </Card>

  <Card title="Builder tools" icon="wrench" href="/mcp/builder/tools-reference">
    The six Builder-mode tools.
  </Card>

  <Card title="SDK reference" icon="code" href="/mcp/builder/sdk-reference">
    The `@jedify/sdk` TypeScript SDK.
  </Card>

  <Card title="Examples" icon="chart-line" href="/mcp/builder/examples">
    Build a dashboard end to end.
  </Card>
</CardGroup>

## Switching modes

Asker mode is the default — no flag needed. To run in Editor or Builder mode, add the matching flag to the proxy `args`:

```json theme={null}
{
  "mcpServers": {
    "jedify": {
      "command": "npx",
      "args": ["-y", "@jedify/mcp-auth", "--builder"]
    }
  }
}
```

| `args`                                    | Mode              |
| ----------------------------------------- | ----------------- |
| `["-y", "@jedify/mcp-auth"]`              | Asker *(default)* |
| `["-y", "@jedify/mcp-auth", "--editor"]`  | Editor            |
| `["-y", "@jedify/mcp-auth", "--builder"]` | Builder           |

On a **hosted agent or app builder** (no local proxy), select Builder mode with the URL `https://be.jedify.com/mcp/message?mode=builder` instead.

See [Connect](/mcp/connect) for the full setup in each client.