# GrelfSwap

Trade tokens and manage assets on the Hedera network through direct integration with SaucerSwap and MemeJob. Execute advanced order types like limit and DCA orders while monitoring real-time prices a…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add grelfswap/hedera-dex

# Browse available tools
npx -y @smithery/cli@latest tool list grelfswap/hedera-dex

# Get full schema for a tool
npx -y @smithery/cli@latest tool get grelfswap/hedera-dex get_status

# Call a tool
npx -y @smithery/cli@latest tool call grelfswap/hedera-dex get_status '{}'
```

## Direct MCP Connection

Endpoint: `https://hedera-dex--grelfswap.run.tools`

## Tools (16)

- `get_status` — GET /status — Check GrelfSwap API availability. Returns supported features, contract addresses, and SDK link. No wallet…
- `get_prices` — GET /prices — Get current USD prices for one or more Hedera tokens. No wallet needed.
- `get_quote` — GET /quote — Preview a swap quote before executing. Shows expected output, price impact, route, and fees. No wallet nee…
- `get_skill` — GET /skill — Get the complete SKILL.md API documentation as markdown text. Comprehensive reference for all endpoints. N…
- `get_sdk` — GET /sdk.js — Get the hosted JavaScript signing helper SDK. Provides functions for signing and submitting Hedera transa…
- `get_balances` — GET /balances — Get token balances for a Hedera wallet, grouped by source (HBAR, SaucerSwap, MemeJob). Zero balances fi…
- `execute_swap` — POST /swap — Execute a token swap on Hedera via SaucerSwap or MemeJob. Returns unsigned transaction bytes to sign and s…
- `associate_token` — POST /associate — Associate a token with a Hedera wallet. Required before receiving any HTS token. Returns unsigned tra…
- `approve_allowance` — POST /approve — Approve token spending allowance for GrelfSwap contracts. Required before swaps for HTS tokens (not nee…
- `transfer_tokens` — POST /transfer — Transfer HBAR or HTS tokens between Hedera accounts. Returns unsigned transaction bytes to sign.
- `create_hcs_topic` — POST /hcs/topic — Create a Hedera Consensus Service (HCS) topic. Returns unsigned transaction bytes to sign.
- `send_hcs_message` — POST /hcs/message — Send a message to an existing HCS topic. Returns unsigned transaction bytes to sign.
- `create_smart_order` — POST /smart-order — Create a limit order or DCA order on GrelfSwap. Supports four strategies: take profit, stop loss, b…
- `get_smart_orders` — GET /smart-orders — List all smart orders (limit + DCA) for a wallet. Requires wallet address.
- `get_smart_order` — GET /smart-order/:id — Get details of a specific smart order by ID. Requires wallet address for ownership verification.
- `cancel_smart_order` — DELETE /smart-order/:id — Cancel an active smart order. Requires wallet address for ownership verification.

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get grelfswap/hedera-dex <tool-name>
```

## Resources

- `docs://openapi.json` — OpenAPI 3.0 specification for all GrelfSwap Agent API endpoints

## Prompts (1)

- `swap_guide` — Step-by-step guide for executing a token swap on Hedera using GrelfSwap tools.