Connecting to Stoneturner

There are two ways to connect your agents to Stoneturner:

Stoneturner hosted MCP

We take care of data storage and incremental syncs so your agents can search your data from anywhere

Stoneturner Local

Your data is privately synced to your local machine (or VPC) - everything you can do on the Stoneturner hosted MCP is available, and all open source

Option 1: Stoneturner Hosted MCP

Just add Stoneturner to your agent config. That’s it!

You can also start at https://app.stoneturner.app to start your syncs and connect your agent to the MCP after.You can also have the agents kick off syncs via the MCP, if you’d like your agent to set everything up.

Claude Code
Codex
OpenCode
ChatGPT
Claude Web

Claude CLI

claude mcp add --transport http stoneturner http://app.stoneturner.app/mcp

.mcp.json manual add

{
  "mcpServers": {
    "stoneturner": {
      "type": "remote",
      "url": "https://app.stoneturner.app/mcp"
    }
  }
}

config.toml

[mcp_servers.stoneturner]
url = "https://app.stoneturner.app/mcp"

.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stoneturner": {
      "type": "remote",
      "url": "https://app.stoneturner.app/mcp",
      "enabled":true
    }
  }
}

Go to ChatGPT’s App Settings
Enable Developer Mode
Create an app and make sure “Authentication” is set to OAuth
Under “Connection” set it to:

Connection

https://app.stoneturner.app/mcp

Go to Claude’s Add Custom Connector
Give the connector a name (i.e. Stoneturner)
Under “Remote MCP Server URL” set it to:

MCP URL

https://app.stoneturner.app/mcp

Option 2: Running Stoneturner Locally

Prerequisites

Before you begin, you must have:

Bun v1.3+
Vercel AI Gateway API key (used for embeddings)

Setting up Stoneturner MCP locally

Install

Clone the repository and install dependencies.

git clone https://github.com/jackmuva/stoneturner.git
cd stoneturner
bun install

Configure environment

Copy the example environment file and fill in your values.

cp .env.example .env

Variable	Required	Description
`BUN_PUBLIC_BACKEND_BASE_URL`	Yes	Backend URL, inlined at build time (e.g. `http://localhost:9000`)
`FRONTEND_BASE_URL`	Yes	Frontend URL, used for CORS (e.g. `http://localhost:9000`)
`AI_GATEWAY_API_KEY`	Yes	API key for the AI gateway (embeddings)
`BUN_PUBLIC_DEV_MODE`	No	Set to `true` to create a test database for developing new integrations (default: `false`)

Set up the database

Generate and apply migrations. This creates a local stoneturner.db Turso/libSQL file — no remote database URL is needed for local development.

bun run generate
bun run migrate

Run the dev server

Start the server with hot reload on port 9000.

bun run start

Connect to Stoneturner

Configure an HTTP-based MCP in your agent config

Claude Code
Codex
OpenCode
ChatGPT
Claude Web

Claude CLI

claude mcp add --transport http stoneturner http://localhost:9000/mcp

.mcp.json manual add

{
  "mcpServers": {
    "stoneturner": {
      "type": "remote",
      "url": "http://localhost:9000/mcp"
    }
  }
}

config.toml

[mcp_servers.stoneturner]
url = "http://localhost:9000/mcp"

.config/opencode/opencode.jsonc

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "stoneturner": {
      "type": "remote",
      "url": "http://localhost:9000/mcp",
      "enabled":true
    }
  }
}

Go to ChatGPT’s App Settings
Enable Developer Mode
Create an app and make sure “Authentication” is set to OAuth
Under “Connection” set it to:

Connection

http://localhost:9000/mcp

Go to Claude’s Add Custom Connector
Give the connector a name (i.e. Stoneturner)
Under “Remote MCP Server URL” set it to:

MCP URL

http://localhost:9000/mcp

Getting Started

For Builders

Reference

Quickstart

Connecting to Stoneturner

Stoneturner hosted MCP

Stoneturner Local

Option 1: Stoneturner Hosted MCP

Option 2: Running Stoneturner Locally

Prerequisites

Setting up Stoneturner MCP locally

Connect to Stoneturner

​Connecting to Stoneturner

Stoneturner hosted MCP

Stoneturner Local

​Option 1: Stoneturner Hosted MCP

​Option 2: Running Stoneturner Locally

​Prerequisites

​Setting up Stoneturner MCP locally

​Connect to Stoneturner

Connecting to Stoneturner

Option 1: Stoneturner Hosted MCP

Option 2: Running Stoneturner Locally

Prerequisites

Setting up Stoneturner MCP locally

Connect to Stoneturner