Skip to main content
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.
VariableDescription
DELORA_API_KEYOptional Delora API key forwarded upstream as x-api-key
DELORA_API_URLOptional override for the Delora API base URL
MCP_TRANSPORTstdio (default) or http
PORTHTTP port when MCP_TRANSPORT=http
HOSTHTTP 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.