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

# MCP Server Setup

# MCP Server Setup

## Quick Start

Run the MCP server instantly — no install, no clone, no setup:

```bash theme={null}
npx @stackfront/mcp-server
```

The server starts in stdio mode and waits for your AI assistant to connect. Leave this terminal running while you work.

## Configuration by Editor

In every case below, use `npx @stackfront/mcp-server` as the command — your AI tool handles the rest.

### Cursor

Create `.cursor/mcp.json` at your project root:

```json theme={null}
{
  "mcpServers": {
    "stackfront": {
      "command": "npx",
      "args": ["@stackfront/mcp-server"]
    }
  }
}
```

After saving, restart Cursor — the MCP server appears in the MCP panel.

### Claude Code

Create or edit `~/.claude/settings.json`:

```json theme={null}
{
  "mcpServers": {
    "stackfront": {
      "command": "npx",
      "args": ["@stackfront/mcp-server"]
    }
  }
}
```

### VS Code (Continue Extension)

In your Continue config (`.continuerc.json` or Continue extension settings):

```json theme={null}
{
  "experimental": {
    "mcpServers": {
      "stackfront": {
        "command": "npx",
        "args": ["@stackfront/mcp-server"]
      }
    }
  }
}
```

### Other MCP-Compatible Tools

Any tool that supports the [Model Context Protocol](https://modelcontextprotocol.io) can connect:

```json theme={null}
{
  "command": "npx",
  "args": ["@stackfront/mcp-server"]
}
```

## Remote (Cloudflare Workers)

For team-wide use or when you don't want a local process, connect to the hosted Workers deployment via SSE:

```json theme={null}
{
  "mcpServers": {
    "stackfront": {
      "type": "sse",
      "url": "https://stackfront-mcp-server.<your-worker>.workers.dev"
    }
  }
}
```

## Internal Development (Full SDK Reflection)

If you need the full capabilities including SDK source introspection (hooks, services, types, GraphQL), clone the monorepo and use the local entry point:

```bash theme={null}
git clone https://github.com/GetThumbly/stackfront.git
cd stackfront/pkgs/mcp-server
npm install
npm run build
npm start
```

Then configure your editor with `node ./dist/index.js` instead of `npx @stackfront/mcp-server`.

## Verify It Works

After connecting, ask your AI assistant:

> "Search the Stackfront docs for cart checkout"
> "Show me a code example for product listing"

For the local monorepo version, you can also ask:

> "Look up the useCart hook in the SDK"

If the assistant returns documentation or code, the MCP server is working correctly.

### What's Included

| Mode             | search\_docs | get\_code\_example | get\_sdk\_api           | Resources  |
| ---------------- | ------------ | ------------------ | ----------------------- | ---------- |
| `npx` / Workers  | ✅            | ✅                  | ❌ (uses docs instead)   | Docs only  |
| Monorepo (local) | ✅            | ✅                  | ✅ (full SDK reflection) | Docs + SDK |