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

# Hosted MCP

> One URL, no install. SAULT runs the MCP server.

SAULT runs a hosted MCP endpoint. Agents add a single config block and gain the full toolset.

## Server URL

```
https://mcp.sault.ai/mcp
```

The server speaks MCP over Streamable HTTP. Tool descriptions and a `SKILL.md` ship as part of the `initialize` handshake, so the agent learns the API on connect.

## Client setup

<AccordionGroup>
  <Accordion title="Claude Desktop">
    Add to `claude_desktop_config.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "sault": {
          "url": "https://mcp.sault.ai/mcp"
        }
      }
    }
    ```

    Restart Claude Desktop.
  </Accordion>

  <Accordion title="Cursor">
    Add to `.cursor/mcp.json`:

    ```json theme={null}
    {
      "mcpServers": {
        "sault": {
          "url": "https://mcp.sault.ai/mcp"
        }
      }
    }
    ```
  </Accordion>

  <Accordion title="Claude Code">
    ```bash theme={null}
    claude mcp add sault --url https://mcp.sault.ai/mcp
    ```
  </Accordion>

  <Accordion title="Windsurf">
    Add to `~/.codeium/windsurf/mcp_config.json` with the same `{ "url": "..." }` form.
  </Accordion>

  <Accordion title="Cline">
    Add via VS Code Settings → Cline → MCP Servers, same `{ "url": "..." }` form.
  </Accordion>
</AccordionGroup>

## Pair the agent

After the client connects, call the `sault_login` tool. It returns an `approveUrl` and a short `verificationCode`. Open the URL in your browser, sign in at app.sault.ai, type the verification code the tool returned into the approve page, and approve.

The MCP session is now bound to a fresh agent key. Subsequent tool calls work without further auth.

If you already have a key from the console, call `sault_pair` with `{ "apiKey": "sault_ak_..." }` instead.

## Tool catalog

| Tool                  | Purpose                              |
| --------------------- | ------------------------------------ |
| `sault_status`        | Show pairing + reachability          |
| `sault_login`         | Browser pairing flow                 |
| `sault_pair`          | Save an existing agent key           |
| `sault_request`       | Make a request — auto-handles 402    |
| `sault_check`         | Probe a URL for 402 without paying   |
| `sault_poll`          | Poll an async paid job               |
| `sault_balance`       | Vault balances per chain             |
| `sault_spending`      | Today's spend vs. cap                |
| `sault_history`       | Recent payments                      |
| `sault_whoami`        | Agent identity, policy, caps         |
| `sault_discover`      | Browse Discover                      |
| `sault_skill_prepare` | Check readiness to run a skill       |
| `sault_skill_show`    | Print a published skill              |
| `sault_topup`         | Get a link to add funds to the vault |

## Session lifetime

Sessions reconnect automatically — if a session drops, the next tool call re-pairs without any action from you. Funds and history live in the vault; only the session binding is temporary.