Delora MCP

MCP (Model Context Protocol) server for the Delora API: cross-chain quotes, supported chains, tokens, and tools.

Install

npm install

Configuration

Copy env.example to .env and adjust:

| Variable | Description | Default | |----------|-------------|---------| | DELORA_API_URL | Delora API base URL | https://api.delora.build | | MCP_TRANSPORT | stdio or http | stdio | | PORT | HTTP server port (when MCP_TRANSPORT=http) | 3000 | | HOST | HTTP bind address | 0.0.0.0 |

Run

Stdio (default) — for Cursor/IDE MCP over stdio:

npm run dev
# or
npm run build && npm start

HTTP — for streamable HTTP (e.g. behind a reverse proxy):

npm run dev:http
# or
npm run build && npm run start:http

Server listens on http://0.0.0.0:3000/mcp.

Cursor configuration

Stdio:

{
  "mcpServers": {
    "delora": {
      "command": "node",
      "args": ["/path/to/delora-mcp/dist/index.js"]
    }
  }
}

Streamable HTTP (e.g. after deploying to https://mcp.delora.build):

{
  "mcpServers": {
    "delora": {
      "url": "https://mcp.delora.build/mcp",
      "transport": "streamable-http"
    }
  }
}

Docker

Build and run:

docker build -t delora-mcp .
docker run -p 3000:3000 -e MCP_TRANSPORT=http delora-mcp

For production behind a domain (e.g. mcp.delora.build): run the container with MCP_TRANSPORT=http and put nginx/traefik (or another reverse proxy) in front with HTTPS; then use the URL https://mcp.delora.build/mcp with streamable-http in Cursor.

API

• Delora API — base URL for all /v1/* endpoints (quotes, chains, tokens, tools, token).

Tools

| Tool | Description | |------|-------------| | get_instructions | Returns this guide (call first for workflow). | | get_quote | GET /v1/quotes — cross-chain quote. | | get_chains | GET /v1/chains — supported chains. | | get_tools | GET /v1/tools — available tools. | | get_tokens | GET /v1/tokens — supported tokens. | | get_token | GET /v1/token — single token by chain + token. |