@hopivia/mcp 0.0.0-stage → 0.1.0

package/README.md

@@ -1,3 +1,78 @@
-# Temporary Holding Version
+# @hopivia/mcp
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+MCP server for the [Hopivia API](https://hopivia.com/docs): the best price across every major DEX of a network, a Tron ↔ EVM USDT bridge and token safety checks — as tools for Claude, Cursor, Windsurf and any other [Model Context Protocol](https://modelcontextprotocol.io) client.
+
+The server runs on your machine and talks to `https://hopivia.com/api/v1` over HTTPS. It never sees a private key and never sends anything on-chain: the write tools return the same **unsigned transactions** as the REST API, and the agent signs them with its own wallet.
+
+## Install
+
+Claude Code:
+
+```bash
+claude mcp add hopivia -- npx -y @hopivia/mcp
+```
+
+Claude Desktop, Cursor, Windsurf — add to the client's MCP config (`claude_desktop_config.json`, `.cursor/mcp.json`, …):
+
+```json
+{
+  "mcpServers": {
+    "hopivia": {
+      "command": "npx",
+      "args": ["-y", "@hopivia/mcp"],
+      "env": { "HOPIVIA_API_KEY": "hk_…" }
+    }
+  }
+}
+```
+
+`HOPIVIA_API_KEY` is optional: without it requests run at the anonymous rate limit (30/min). Free keys (120/min) are issued at <https://hopivia.com/agents> by signing a message with a wallet — no gas, no registration.
+
+## Tools
+
+| Tool | What it does |
+|---|---|
+| `list_chains` | networks, venues and bridge directions |
+| `list_tokens` | known tokens of a chain (any ERC-20 also works by address) |
+| `get_quote` | best same-chain price: amountOut, venue, route, price impact, fee |
+| `build_swap_transactions` | unsigned approvals + swap in `steps`; optional `simulate`, `checkSafety`, `maxPriceImpactPct` |
+| `get_bridge_quote` | cross-chain quote (EVM ↔ EVM via LI.FI, Tron ↔ EVM USDT via Symbiosis) |
+| `build_bridge_transactions` | unsigned cross-chain steps (EVM calldata or TronWeb parameters) |
+| `get_bridge_status` | status of a transfer by its source tx hash |
+| `check_token` | metadata + GoPlus safety check (honeypot, taxes, owner privileges) |
+| `get_balances` | native + token balances of an address |
+| `api_key_info` | tier, limit and usage of the configured key |
+
+Resource `hopivia://docs` — the full API guide as Markdown (same as <https://hopivia.com/docs.md>).
+
+Refusals of the API (HTTP 422: `simulation_reverted`, `price_impact_too_high`, `token_risk_high`, `insufficient_balance`) come back as tool errors with the API's `error` and `message`, so the agent can explain and fix the request.
+
+## Environment
+
+| Variable | Default | Meaning |
+|---|---|---|
+| `HOPIVIA_API_KEY` | — | `X-API-Key` for higher limits |
+| `HOPIVIA_API_URL` | `https://hopivia.com/api/v1` | API base (point it at a local API for development) |
+| `HOPIVIA_SITE_URL` | `https://hopivia.com` | site base for docs links and the docs resource |
+
+## Programmatic use
+
+```ts
+import { createServer } from '@hopivia/mcp';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+
+const server = createServer({ apiKey: process.env.HOPIVIA_API_KEY });
+await server.connect(new StdioServerTransport());
+```
+
+## Development
+
+```bash
+npm install                      # at the repository root (workspaces)
+npm run build -w @hopivia/mcp
+npm test -w @hopivia/mcp         # unit tests with a fake API
+npm run smoke:mcp                # end to end over stdio against https://hopivia.com (BASE=… to override)
+npx @modelcontextprotocol/inspector node packages/mcp/dist/cli.js
+```
+
+Publish: `npm version patch -w @hopivia/mcp && npm publish --access public -w @hopivia/mcp` (needs an npm account that owns the `hopivia` scope).

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+// `npx @hopivia/mcp` — stdio MCP server for Claude Desktop, Claude Code, Cursor and any other MCP client.
+// Configuration (all optional): HOPIVIA_API_KEY, HOPIVIA_API_URL (default https://hopivia.com/api/v1),
+// HOPIVIA_SITE_URL (default https://hopivia.com).
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { createServer } from './server.js';
+import { VERSION } from './version.js';
+const arg = process.argv[2];
+if (arg === '--version' || arg === '-v') {
+    console.log(VERSION);
+    process.exit(0);
+}
+if (arg === '--help' || arg === '-h') {
+    console.log(`@hopivia/mcp ${VERSION} — MCP server for the Hopivia API (https://hopivia.com/docs)
+
+Usage: hopivia-mcp            start the stdio server (what MCP clients run)
+       hopivia-mcp --version
+
+Environment:
+  HOPIVIA_API_KEY   optional X-API-Key; free keys at https://hopivia.com/agents
+  HOPIVIA_API_URL   API base, default https://hopivia.com/api/v1
+  HOPIVIA_SITE_URL  site base for docs links, default https://hopivia.com
+
+Claude Code:   claude mcp add hopivia -- npx -y @hopivia/mcp
+Claude Desktop / Cursor: {"mcpServers":{"hopivia":{"command":"npx","args":["-y","@hopivia/mcp"]}}}`);
+    process.exit(0);
+}
+const server = createServer({
+    apiKey: process.env.HOPIVIA_API_KEY,
+    baseUrl: process.env.HOPIVIA_API_URL,
+    siteUrl: process.env.HOPIVIA_SITE_URL,
+    userAgent: `hopivia-mcp/${VERSION}`,
+});
+await server.connect(new StdioServerTransport());
+//# sourceMappingURL=cli.js.map

package/dist/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,0GAA0G;AAC1G,uGAAuG;AACvG,kDAAkD;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAEvC,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAC5B,IAAI,GAAG,KAAK,WAAW,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;IACxC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AACD,IAAI,GAAG,KAAK,QAAQ,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;IACrC,OAAO,CAAC,GAAG,CAAC,gBAAgB,OAAO;;;;;;;;;;;mGAW8D,CAAC,CAAC;IACnG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,YAAY,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;IACnC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,eAAe;IACpC,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,gBAAgB;IACrC,SAAS,EAAE,eAAe,OAAO,EAAE;CACpC,CAAC,CAAC;AACH,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,24 @@
+export type ClientOptions = {
+    baseUrl?: string;
+    apiKey?: string;
+    fetchImpl?: typeof fetch;
+    userAgent?: string;
+};
+export declare class ApiError extends Error {
+    status: number;
+    body: unknown;
+    constructor(status: number, body: unknown);
+}
+type Query = Record<string, string | number | boolean | undefined>;
+export declare class HopiviaClient {
+    readonly baseUrl: string;
+    private readonly apiKey?;
+    private readonly fetchImpl;
+    private readonly userAgent;
+    constructor(opts?: ClientOptions);
+    get hasKey(): boolean;
+    get<T = unknown>(path: string, query?: Query): Promise<T>;
+    post<T = unknown>(path: string, body: Record<string, unknown>): Promise<T>;
+    private send;
+}
+export {};

package/dist/client.js

@@ -0,0 +1,61 @@
+// Thin client for the Hopivia REST API (https://hopivia.com/docs). The MCP tools are a 1:1 map of
+// its endpoints, so everything the server returns (including 4xx refusals with their reasons)
+// is passed to the agent as-is.
+export class ApiError extends Error {
+    status;
+    body;
+    constructor(status, body) {
+        super(`Hopivia API ${status}`);
+        this.status = status;
+        this.body = body;
+    }
+}
+export class HopiviaClient {
+    baseUrl;
+    apiKey;
+    fetchImpl;
+    userAgent;
+    constructor(opts = {}) {
+        this.baseUrl = (opts.baseUrl ?? 'https://hopivia.com/api/v1').replace(/\/+$/, '');
+        this.apiKey = opts.apiKey;
+        this.fetchImpl = opts.fetchImpl ?? fetch;
+        this.userAgent = opts.userAgent ?? 'hopivia-mcp';
+    }
+    get hasKey() {
+        return Boolean(this.apiKey);
+    }
+    async get(path, query = {}) {
+        const url = new URL(this.baseUrl + path);
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined && v !== '')
+                url.searchParams.set(k, String(v));
+        }
+        return this.send(url, { method: 'GET' });
+    }
+    async post(path, body) {
+        const clean = Object.fromEntries(Object.entries(body).filter(([, v]) => v !== undefined && v !== ''));
+        return this.send(new URL(this.baseUrl + path), {
+            method: 'POST',
+            headers: { 'content-type': 'application/json' },
+            body: JSON.stringify(clean),
+        });
+    }
+    async send(url, init) {
+        const headers = new Headers(init.headers);
+        headers.set('accept', 'application/json');
+        headers.set('user-agent', this.userAgent);
+        if (this.apiKey)
+            headers.set('x-api-key', this.apiKey);
+        const res = await this.fetchImpl(url, { ...init, headers });
+        const text = await res.text();
+        let json = text;
+        try {
+            json = text ? JSON.parse(text) : null;
+        }
+        catch { /* non-JSON body: keep the text */ }
+        if (!res.ok)
+            throw new ApiError(res.status, json);
+        return json;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,8FAA8F;AAC9F,gCAAgC;AAShC,MAAM,OAAO,QAAS,SAAQ,KAAK;IACd;IAAuB;IAA1C,YAAmB,MAAc,EAAS,IAAa;QACrD,KAAK,CAAC,eAAe,MAAM,EAAE,CAAC,CAAC;QADd,WAAM,GAAN,MAAM,CAAQ;QAAS,SAAI,GAAJ,IAAI,CAAS;IAEvD,CAAC;CACF;AAID,MAAM,OAAO,aAAa;IACf,OAAO,CAAS;IACR,MAAM,CAAU;IAChB,SAAS,CAAe;IACxB,SAAS,CAAS;IAEnC,YAAY,OAAsB,EAAE;QAClC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,IAAI,4BAA4B,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QAClF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC;QAC1B,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,KAAK,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,IAAI,aAAa,CAAC;IACnD,CAAC;IAED,IAAI,MAAM;QACR,OAAO,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAED,KAAK,CAAC,GAAG,CAAc,IAAY,EAAE,QAAe,EAAE;QACpD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,CAAC;QACzC,KAAK,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;YAC3C,IAAI,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE;gBAAE,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QACtE,CAAC;QACD,OAAO,IAAI,CAAC,IAAI,CAAI,GAAG,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,CAAC;IAED,KAAK,CAAC,IAAI,CAAc,IAAY,EAAE,IAA6B;QACjE,MAAM,KAAK,GAAG,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,SAAS,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;QACtG,OAAO,IAAI,CAAC,IAAI,CAAI,IAAI,GAAG,CAAC,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE;YAChD,MAAM,EAAE,MAAM;YACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE;YAC/C,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC;SAC5B,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,IAAI,CAAI,GAAQ,EAAE,IAAiB;QAC/C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,QAAQ,EAAE,kBAAkB,CAAC,CAAC;QAC1C,OAAO,CAAC,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,IAAI,CAAC,MAAM;YAAE,OAAO,CAAC,GAAG,CAAC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;QACvD,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;QAC9B,IAAI,IAAI,GAAY,IAAI,CAAC;QACzB,IAAI,CAAC;YAAC,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QAAC,CAAC;QAAC,MAAM,CAAC,CAAC,kCAAkC,CAAC,CAAC;QAC3F,IAAI,CAAC,GAAG,CAAC,EAAE;YAAE,MAAM,IAAI,QAAQ,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;QAClD,OAAO,IAAS,CAAC;IACnB,CAAC;CACF"}

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+export { createServer, type ServerOptions } from './server.js';
+export { HopiviaClient, ApiError, type ClientOptions } from './client.js';
+export { VERSION } from './version.js';

package/dist/index.js

@@ -0,0 +1,4 @@
+export { createServer } from './server.js';
+export { HopiviaClient, ApiError } from './client.js';
+export { VERSION } from './version.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,QAAQ,EAAsB,MAAM,aAAa,CAAC;AAC1E,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,6 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type ClientOptions } from './client.js';
+export type ServerOptions = ClientOptions & {
+    siteUrl?: string;
+};
+export declare function createServer(opts?: ServerOptions): McpServer;

package/dist/server.js

@@ -0,0 +1,173 @@
+// MCP server for the Hopivia API: one tool per endpoint. Everything is read-only from the
+// server's point of view — the write tools return UNSIGNED transactions that the agent signs
+// with its own wallet. The server never sees a private key and never sends anything on-chain.
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { z } from 'zod';
+import { ApiError, HopiviaClient } from './client.js';
+import { VERSION } from './version.js';
+const CHAIN = 'Chain id or key: 56|bsc, 1|ethereum, 42161|arbitrum, 8453|base, 137|polygon, 10|optimism, 43114|avalanche, 204|opbnb. Call list_chains for the live set.';
+const TOKEN = '"native" for the chain coin (BNB, ETH, POL…), a symbol from list_tokens (USDT, USDC, …) or a 0x address.';
+const AMOUNT = 'Amount in human units, e.g. "0.5". Alternative: amountWei in the smallest unit.';
+const SLIPPAGE = 'Slippage tolerance in basis points, 50 = 0.5% (default 50).';
+const SIGNING_RULES = [
+    'The result contains unsigned transactions in `steps` — sign and send them with your own wallet, strictly in order, waiting for each to confirm.',
+    'Never ask the user for a private key; never send keys anywhere.',
+    'Quote first, show the user the amount out, the fee and the price impact, and get a confirmation before building and sending transactions.',
+].join(' ');
+const text = (data) => ({ content: [{ type: 'text', text: JSON.stringify(data, null, 2) }] });
+const failure = (err) => {
+    if (err instanceof ApiError) {
+        // 4xx refusals carry a machine-readable `error` and a human `message`: pass them through so the
+        // agent can explain (and fix the request) instead of guessing
+        return { isError: true, content: [{ type: 'text', text: JSON.stringify({ status: err.status, ...(typeof err.body === 'object' && err.body ? err.body : { message: String(err.body) }) }, null, 2) }] };
+    }
+    return { isError: true, content: [{ type: 'text', text: JSON.stringify({ error: 'request_failed', message: err instanceof Error ? err.message : String(err) }) }] };
+};
+export function createServer(opts = {}) {
+    const api = new HopiviaClient(opts);
+    const siteUrl = (opts.siteUrl ?? 'https://hopivia.com').replace(/\/+$/, '');
+    const server = new McpServer({ name: 'hopivia', version: VERSION }, {
+        instructions: [
+            'Hopivia gives you the best price across every major DEX of a network, a Tron ↔ EVM USDT bridge and token safety checks.',
+            'Read tools: list_chains, list_tokens, get_quote, get_bridge_quote, get_bridge_status, check_token, get_balances.',
+            'Write tools (build_swap_transactions, build_bridge_transactions) return UNSIGNED transactions — you sign and send them yourself, in order.',
+            SIGNING_RULES,
+            `Full guide: ${siteUrl}/docs.md (also available as the resource hopivia://docs).`,
+        ].join('\n'),
+    });
+    const run = async (fn) => {
+        try {
+            return text(await fn());
+        }
+        catch (err) {
+            return failure(err);
+        }
+    };
+    server.registerTool('list_chains', {
+        title: 'Supported chains',
+        description: 'Networks Hopivia supports and what each offers (same-chain venues, bridge directions, native coin). Call this first when unsure which chain key to use.',
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async () => run(() => api.get('/chains')));
+    server.registerTool('list_tokens', {
+        title: 'Known tokens of a chain',
+        description: 'Known tokens (symbol, address, decimals) of one chain. Any other ERC-20 can still be used by its 0x address in the other tools.',
+        inputSchema: {
+            chain: z.string().describe(CHAIN),
+            q: z.string().optional().describe('Filter by symbol, name or address.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async ({ chain, q }) => run(() => api.get('/tokens', { chain, q })));
+    server.registerTool('get_quote', {
+        title: 'Best same-chain price',
+        description: 'Best price for a same-chain swap across all connected DEXes. Returns amountOut, the venue and route, price impact, Hopivia fee (feeBps) and gas estimate. No transaction is built.',
+        inputSchema: {
+            chain: z.string().describe(CHAIN),
+            tokenIn: z.string().describe(TOKEN),
+            tokenOut: z.string().describe(TOKEN),
+            amount: z.string().optional().describe(AMOUNT),
+            amountWei: z.string().optional().describe('Amount in the smallest unit (alternative to amount).'),
+            slippageBps: z.number().int().min(1).max(5000).optional().describe(SLIPPAGE),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.get('/quote', a)));
+    server.registerTool('build_swap_transactions', {
+        title: 'Build same-chain swap transactions (unsigned)',
+        description: `Unsigned transactions for the best same-chain swap: approvals / Permit2 allowance first, then the swap, in \`steps\`. ${SIGNING_RULES} Optional safety rails: simulate (dry-run, reverts are refused), checkSafety (GoPlus check of tokenOut, high risk refused with 422), maxPriceImpactPct.`,
+        inputSchema: {
+            chain: z.string().describe(CHAIN),
+            tokenIn: z.string().describe(TOKEN),
+            tokenOut: z.string().describe(TOKEN),
+            amount: z.string().optional().describe(AMOUNT),
+            amountWei: z.string().optional().describe('Amount in the smallest unit (alternative to amount).'),
+            from: z.string().describe('Sender 0x address — the wallet that will sign.'),
+            recipient: z.string().optional().describe('Recipient of tokenOut; defaults to from.'),
+            slippageBps: z.number().int().min(1).max(5000).optional().describe(SLIPPAGE),
+            simulate: z.boolean().optional().describe('Dry-run the swap with eth_estimateGas; a revert is refused with 422.'),
+            checkSafety: z.boolean().optional().describe('GoPlus check on tokenOut; risk "high" is refused with 422 unless allowRiskyToken.'),
+            allowRiskyToken: z.boolean().optional().describe('Build even if tokenOut is a honeypot / >50% sell tax / owner can mint or pause.'),
+            maxPriceImpactPct: z.number().min(0).max(100).optional().describe('Refuse with 422 price_impact_too_high above this percentage.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.post('/swap/tx', a)));
+    server.registerTool('get_bridge_quote', {
+        title: 'Cross-chain quote',
+        description: 'Quote for a cross-chain swap: EVM ↔ EVM via LI.FI, Tron ↔ EVM via Symbiosis (USDT only on the Tron side). Returns amountOut, fees in USD, estimated time and warnings (e.g. Tron Energy needs). Bridging small amounts loses a large share to fixed fees — the quote warns above 10%.',
+        inputSchema: {
+            fromChain: z.string().describe(`${CHAIN} Plus "tron" (USDT only).`),
+            toChain: z.string().describe(`${CHAIN} Plus "tron" (USDT only).`),
+            fromToken: z.string().describe(TOKEN),
+            toToken: z.string().describe(TOKEN),
+            amount: z.string().optional().describe(AMOUNT),
+            amountWei: z.string().optional().describe('Amount in the smallest unit (alternative to amount).'),
+            from: z.string().optional().describe('Sender on fromChain (0x… or T…). Required later for build_bridge_transactions.'),
+            to: z.string().optional().describe('Recipient on toChain. Required when the address formats differ (Tron ↔ EVM) — always confirm it with the user.'),
+            slippageBps: z.number().int().min(1).max(5000).optional().describe(SLIPPAGE),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.get('/bridge/quote', a)));
+    server.registerTool('build_bridge_transactions', {
+        title: 'Build cross-chain transactions (unsigned)',
+        description: `Unsigned transactions for a cross-chain swap in \`steps\` (EVM: approve + bridge call; Tron: tron-approve + tron-call with what TronWeb needs). ${SIGNING_RULES} For Tron ↔ EVM always pass \`to\` in the destination network's format and confirm it with the user.`,
+        inputSchema: {
+            fromChain: z.string().describe(`${CHAIN} Plus "tron" (USDT only).`),
+            toChain: z.string().describe(`${CHAIN} Plus "tron" (USDT only).`),
+            fromToken: z.string().describe(TOKEN),
+            toToken: z.string().describe(TOKEN),
+            amount: z.string().optional().describe(AMOUNT),
+            amountWei: z.string().optional().describe('Amount in the smallest unit (alternative to amount).'),
+            from: z.string().describe('Sender on fromChain (0x… or T…) — the wallet that will sign.'),
+            to: z.string().optional().describe('Recipient on toChain; required when the address formats differ (Tron ↔ EVM).'),
+            slippageBps: z.number().int().min(1).max(5000).optional().describe(SLIPPAGE),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.post('/bridge/tx', a)));
+    server.registerTool('get_bridge_status', {
+        title: 'Cross-chain transfer status',
+        description: 'Status of a cross-chain transfer by its source transaction hash: pending / done / failed, destination tx hash when known. Poll every ~30 s; Tron ↔ EVM usually takes 2–10 minutes.',
+        inputSchema: {
+            provider: z.enum(['lifi', 'symbiosis']).describe('Provider named in the bridge quote / tx response.'),
+            txHash: z.string().describe('Source-chain transaction hash of the bridge call.'),
+            fromChain: z.string().describe(`${CHAIN} Plus "tron".`),
+            toChain: z.string().describe(`${CHAIN} Plus "tron".`),
+            bridge: z.string().optional().describe('LI.FI tool name from build_bridge_transactions (LI.FI only).'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.get('/bridge/status', a)));
+    server.registerTool('check_token', {
+        title: 'Token metadata + safety check',
+        description: 'Token metadata (symbol, decimals, name) and a GoPlus safety check: honeypot, buy/sell tax, owner privileges (mint, pause, blacklist), with an overall risk level. Run it before buying anything the user did not name explicitly.',
+        inputSchema: {
+            chain: z.string().describe(CHAIN),
+            address: z.string().describe('0x token address.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.get('/token/check', a)));
+    server.registerTool('get_balances', {
+        title: 'Balances of an address',
+        description: 'Native coin and known-token balances of an address on one chain (plus any extra token addresses you pass). Use it to check the user has enough tokenIn and gas before building transactions.',
+        inputSchema: {
+            chain: z.string().describe(CHAIN),
+            address: z.string().describe('0x address to inspect.'),
+            tokens: z.string().optional().describe('Comma-separated extra 0x token addresses to include.'),
+        },
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async (a) => run(() => api.get('/balances', a)));
+    server.registerTool('api_key_info', {
+        title: 'Current API key',
+        description: `Tier, rate limit and usage of the configured API key (HOPIVIA_API_KEY). Without a key the API still works at the anonymous limit; free keys are issued at ${siteUrl}/agents by signing a message with a wallet.`,
+        inputSchema: {},
+        annotations: { readOnlyHint: true, openWorldHint: true },
+    }, async () => (api.hasKey ? run(() => api.get('/keys/me')) : text({ configured: false, hint: `No HOPIVIA_API_KEY set — requests run at the anonymous rate limit. Get a free key at ${siteUrl}/agents.` })));
+    // The guide the tools are documented in, as a resource the client can attach to context
+    server.registerResource('docs', 'hopivia://docs', {
+        title: 'Hopivia API guide',
+        description: 'The full API guide as Markdown: quick start, every endpoint, errors and refusals, fees, rules for AI agents.',
+        mimeType: 'text/markdown',
+    }, async (uri) => {
+        const res = await (opts.fetchImpl ?? fetch)(`${siteUrl}/docs.md`, { headers: { accept: 'text/markdown' } });
+        return { contents: [{ uri: uri.href, mimeType: 'text/markdown', text: await res.text() }] };
+    });
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.js","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1 @@
+export declare const VERSION = "0.1.0";

package/dist/version.js

@@ -0,0 +1,3 @@
+// Kept in sync with package.json by `npm version` (see the "version" script there)
+export const VERSION = '0.1.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -1,6 +1,45 @@
 {
   "name": "@hopivia/mcp",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.1.0",
+  "description": "MCP server for the Hopivia API: best-price DEX quotes, unsigned swap and bridge transactions, token safety checks — as tools for Claude, Cursor and other MCP clients",
+  "license": "MIT",
+  "type": "module",
+  "homepage": "https://hopivia.com/docs#mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/gyuikyh/dee-back.git",
+    "directory": "packages/mcp"
+  },
+  "keywords": ["mcp", "model-context-protocol", "dex", "defi", "swap", "bridge", "hopivia", "ai-agents"],
+  "bin": {
+    "hopivia-mcp": "./dist/cli.js"
+  },
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -b && node -e \"require('fs').chmodSync('dist/cli.js', 0o755)\"",
+    "test": "vitest run",
+    "version": "node -e \"const v=require('./package.json').version;require('fs').writeFileSync('src/version.ts','// Kept in sync with package.json by `npm version` (see the \\\"version\\\" script there)\\nexport const VERSION = \\''+v+'\\';\\n')\" && git add src/version.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.32.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "vitest": "^3.0.0"
+  }
+}