Installation

You can either run the MCP server locally using the official Delora MCP npm package or connect directly to the hosted MCP endpoint.

1. Run the Delora MCP Package Locally

Run the Delora MCP package locally.

Quick Start (npx)

Run directly without installing globally:

npx -y @deloraprotocol/mcp@latest

This starts the server in stdio mode (default), which is suitable for most local AI agent integrations.

Optional Environment Variables

Use environment variables when you want the MCP server to forward your Delora API key or use a custom upstream API URL.

Variable	Description
`DELORA_API_KEY`	Optional Delora API key forwarded upstream as `x-api-key`
`DELORA_API_URL`	Optional override for the Delora API base URL
`MCP_TRANSPORT`	`stdio` (default) or `http`
`PORT`	HTTP port when `MCP_TRANSPORT=http`
`HOST`	HTTP bind address when `MCP_TRANSPORT=http`

Example:

# macOS / Linux
DELORA_API_KEY=YOUR_API_KEY npx -y @deloraprotocol/mcp@latest

# Windows PowerShell
$env:DELORA_API_KEY="YOUR_API_KEY"
npx -y @deloraprotocol/mcp@latest

DELORA_API_KEY is the correct way to provide a key in stdio mode. In HTTP mode, you can also send x-api-key or Authorization: Bearer ... as incoming request headers when your MCP client supports custom headers.

Installation from Source

Clone and build manually:

git clone https://github.com/DeloraProtocol/delora-mcp.git
cd delora-mcp
npm install
npm run build

Running the Server

stdio mode (default):

npx -y @deloraprotocol/mcp@latest
# or from a cloned repository
npm start

HTTP mode:

MCP_TRANSPORT=http npx -y @deloraprotocol/mcp@latest
# or from a cloned repository
npm run start:http

# Custom Port
MCP_TRANSPORT=http PORT=3001 npx -y @deloraprotocol/mcp@latest

Configuration for Agent Frameworks

stdio configuration (local agents):

{
  "delora": {
    "type": "stdio",
    "command": "npx",
    "args": ["-y", "@deloraprotocol/mcp@latest"],
    "env": {
      "DELORA_API_KEY": "YOUR_API_KEY"
    }
  }
}

If your MCP client supports per-server environment variables, set DELORA_API_KEY there. This keeps the key on the MCP server side and works for both local stdio usage and self-hosted MCP servers.

Streamable HTTP:

"delora": {
  "type": "streamable-http",
  "url": "http://localhost:3000/mcp",
  "headers": {
    "x-api-key": "YOUR_API_KEY"
  }
}

You can also use:

"headers": {
  "Authorization": "Bearer YOUR_API_KEY"
}

if your MCP client supports custom HTTP headers.

Claude Code (CLI & IDE plugins)

Add the MCP server:

claude mcp add delora npx -- -y @deloraprotocol/mcp@latest
# OR
claude mcp add delora --transport http http://127.0.0.1:3000/mcp

Verify the connection:

claude mcp list

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "delora": {
      "command": "npx",
      "args": ["-y", "@deloraprotocol/mcp@latest"]
    }
  }
}

GitHub Copilot (VS Code Chat)

Add to .vscode/mcp.json in your workspace:

{
  "mcpServers": {
    "delora": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@deloraprotocol/mcp@latest"]
    }
  }
}

Windsurf

Add to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "delora": {
      "command": "npx",
      "args": ["-y", "@deloraprotocol/mcp@latest"]
    }
  }
}

Development

# Run in dev mode (no build needed)
npm run dev

# Run local HTTP mode in dev
npm run dev:http

# Build production output
npm run build

2. Use the Delora Hosted MCP Server

The fastest way to get started is by connecting to the hosted Delora MCP endpoint. No local installation required. MCP endpoint:

https://mcp.delora.build/mcp

The hosted endpoint works without local setup. If your MCP client supports custom HTTP headers, you can pass x-api-key or Authorization: Bearer ... directly to https://mcp.delora.build/mcp. If your client does not support headers, use a local or self-hosted Delora MCP server with DELORA_API_KEY.

Below are setup instructions for supported AI tools.

Claude Desktop

Add to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "delora": {
      "type": "http",
      "url": "https://mcp.delora.build/mcp"
    }
  }
}

Claude Code

Add via CLI:

claude mcp add delora --transport http --url https://mcp.delora.build/mcp

Or create a .mcp.json file in your project root:

{
  "servers": {
    "delora": {
      "type": "http",
      "url": "https://mcp.delora.build/mcp"
    }
  }
}

Cursor

Add to .cursor/mcp.json (project-level) or ~/.cursor/mcp.json (global):

{
  "mcpServers": {
    "delora": {
      "url": "https://mcp.delora.build/mcp"
    }
  }
}

Testing Your Setup

You can verify that the MCP server is running correctly using the MCP Inspector:

npx @modelcontextprotocol/inspector --url https://mcp.delora.build/mcp

This will open a web UI at http://localhost:6274 where you can browse and interact with all available tools. Alternatively, you can test your AI tool by sending a simple request to the server. If it is configured correctly, it will respond with the expected tool outputs.

Getting Started

Reference

1. Run the Delora MCP Package Locally

Quick Start (npx)

Optional Environment Variables

Installation from Source

Running the Server

Configuration for Agent Frameworks

Claude Code (CLI & IDE plugins)

Cursor

GitHub Copilot (VS Code Chat)

Windsurf

Development

2. Use the Delora Hosted MCP Server

Claude Desktop

Claude Code

Cursor

Testing Your Setup

​1. Run the Delora MCP Package Locally

​Quick Start (npx)

​Optional Environment Variables

​Installation from Source

​Running the Server

​Configuration for Agent Frameworks

​Claude Code (CLI & IDE plugins)

​Cursor

​GitHub Copilot (VS Code Chat)

​Windsurf

​Development

​2. Use the Delora Hosted MCP Server

​Claude Desktop

​Claude Code

​Cursor

​Testing Your Setup

1. Run the Delora MCP Package Locally

Quick Start (npx)

Optional Environment Variables

Installation from Source

Running the Server

Configuration for Agent Frameworks

Claude Code (CLI & IDE plugins)

Cursor

GitHub Copilot (VS Code Chat)

Windsurf

Development

2. Use the Delora Hosted MCP Server

Claude Desktop

Claude Code

Cursor

Testing Your Setup