{
  "markdown": "# Delora MCP\n\nMCP (Model Context Protocol) server for the [Delora](https://api.delora.build) API: cross-chain quotes, supported chains, tokens, and tools.\n\n## Install\n\n```bash\nnpm install\n```\n\n## Configuration\n\nCopy `env.example` to `.env` and adjust:\n\n| Variable | Description | Default |\n|----------|-------------|---------|\n| `DELORA_API_URL` | Delora API base URL | `https://api.delora.build` |\n| `DELORA_API_KEY` | Optional API key forwarded to Delora API as `x-api-key` | unset |\n| `MCP_TRANSPORT` | `stdio` or `http` | `stdio` |\n| `PORT` | HTTP server port (when `MCP_TRANSPORT=http`) | `3000` |\n| `HOST` | HTTP bind address | `0.0.0.0` |\n\nWhen `DELORA_API_KEY` is set, the MCP server forwards it to Delora API as the `x-api-key` header. In HTTP mode, the server also accepts incoming `x-api-key` or `Authorization: Bearer ...` headers and forwards the resolved key upstream. For HTTP requests, incoming headers take priority over `DELORA_API_KEY`. For stdio, `DELORA_API_KEY` remains the way to provide the key.\n\n## Run\n\n**Stdio (default)** — for Cursor/IDE MCP over stdio:\n\n```bash\nnpm run dev\n# or\nnpm run build && npm start\n```\n\n**HTTP** — for streamable HTTP (e.g. behind a reverse proxy):\n\n```bash\nnpm run dev:http\n# or\nnpm run build && npm run start:http\n```\n\nServer listens on `http://0.0.0.0:3000/mcp`.\n\n## Cursor configuration\n\n**Stdio:**\n\n```json\n{\n  \"mcpServers\": {\n    \"delora\": {\n      \"command\": \"node\",\n      \"args\": [\"/path/to/delora-mcp/dist/index.js\"]\n    }\n  }\n}\n```\n\n**Streamable HTTP** (e.g. after deploying to `https://mcp.delora.build`):\n\n```json\n{\n  \"mcpServers\": {\n    \"delora\": {\n      \"url\": \"https://mcp.delora.build/mcp\",\n      \"transport\": \"streamable-http\",\n      \"headers\": {\n        \"x-api-key\": \"YOUR_API_KEY\"\n      }\n    }\n  }\n}\n```\n\nYou can also use `Authorization: Bearer YOUR_API_KEY` instead of `x-api-key` when your MCP client supports custom HTTP headers.\n\n## Docker\n\nBuild and run:\n\n```bash\ndocker build -t delora-mcp .\ndocker run -p 3000:3000 -e MCP_TRANSPORT=http delora-mcp\n```\n\nFor 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.\n\n## API\n\n- [Delora API](https://api.delora.build) — base URL for all `/v1/*` endpoints (quotes, chains, tokens, tools, token).\n\n## Tools\n\n| Tool | Description |\n|------|-------------|\n| `get_instructions` | Returns this guide (call first for workflow). |\n| `get_quote` | GET /v1/quotes — cross-chain quote. |\n| `get_chains` | GET /v1/chains — supported chains. |\n| `get_tools` | GET /v1/tools — available tools. |\n| `get_tokens` | GET /v1/tokens — supported tokens. |\n| `get_token` | GET /v1/token — single token by chain + token. |\n",
  "bytes": 2817,
  "sha": "d50181aa74704c1fea8e8f2430c8575c74c8438aa6b1b2df2e561c1917856da9",
  "repo_slug": "deloraprotocol/delora-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_deloraprotocol_delora_mcp_08259394/readme"
}