Epsilon

io.github.alienbase-xyzPublished by GitHub account alienbase-xyzv0.4.0Updated Oct 25, 2026

Non-custodial limit, stop-loss and DCA trading on Epsilon (Robinhood Chain) for AI agents

VerifiedStreamable HTTPWeb executableFinanceDeveloper Tools

Overview

AI-generated overview

Non-custodial trading MCP server for Epsilon on Robinhood Chain, letting an assistant quote swaps, inspect markets and place limit, stop, DCA and trailing-stop,

What you can do
Resolve tokens and search Epsilon developer docs and integration examples, no API key needed for docs and examples. Get swap quotes, full routing breakdowns, orderbook depth and market statistics. Check whether a resting order would be executable and read the error catalog for retry guidance. List a wallet's orders and fills, fetch a single order, and check account, agent grant and approval status. Place market, limit, stop, DCA and trailing-stop orders, and request cancellation of open orders via approval links.
When to use it
Useful when an assistant should help with trading on Epsilon: checking prices and liquidity, reviewing a wallet's order history, or preparing orders that the user then signs in the Epsilon app. Also handy for looking up Epsilon API docs, error codes and example integrations.
Requirements
Runs as a remote endpoint or as a local npm package over stdio. Requires an Epsilon developer key supplied as EPSILON_API_KEY or the X-API-Key header. Read-only use (quotes, order status, market stats) works without a wallet key; placing orders needs EPSILON_WALLET_KEY for a dedicated trading wallet. Some account tools need an OAuth session. Network access to Epsilon is required.
Before you install
EPSILON_WALLET_KEY is a private key for a trading wallet and EPSILON_API_KEY is a secret; keep both out of logs and shared configs. Orders move real funds on-chain. Placing orders returns approval links that the user must sign in the Epsilon app, and keeper-executed limit, stop and DCA orders keep working after the chat closes. EPSILON_REFERRER redirects the referral leg of every routed fill to that address on-chain. Amounts are raw token units, so scaling errors can misprice an order.

Installation

In SourceWeft

  1. Open Epsilon in the dashboard and add it to a workspace.
  2. Connect X-API-Key credentials. They are stored privately and never shown on public pages.
  3. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.alienbase-xyz%2Fepsilon/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "epsilon": {
      "type": "http",
      "url": "https://api.epsilon.exchange/mcp",
      "headers": {
        "X-API-Key": "<YOUR_API_KEY>"
      }
    }
  }
}

README

This repository has no README.

Tools

22

cancel_order

Cancel Order (needs approval)

Ask the user to approve cancelling one of their open orders (hash from list_orders). Returns an approval link; the cancellation is signed by the user's wallet in the Epsilon app. Orders already filled cannot be cancelled.

ParametersnoteorderHashrequired

check_order

Order Preflight Check

Check whether a resting order (limit, stop, DCA, trailing) for this pair and size would be executable: oracle support, liquidity, minimum size. Run this before signing any resting order; it does not price the trade — get_route does. Amounts are RAW token units.

ParameterstokenInrequiredamountInrequiredtokenOutrequired

get_approval

Get Approval Status

Status of an approval you created: pending (user hasn't decided), submitted (with orderHash or txHash — then use get_order to follow fills), rejected, failed, or expired (links live 30 minutes). Poll no more than every few seconds.

Parametersidrequired

get_error_catalog

API Error Catalog

Machine-readable catalog of every error code the Epsilon API returns, with meanings and retry guidance. Consult it when any other tool returns an error code you need to interpret or decide whether to retry.

Takes no parameters.

get_example

Get Code Example

Full source code of one Epsilon integration example, by id from list_examples. No API key required.

Parametersidrequired

get_grant

Get Agent Grant

The signed-in account's agent grant for this channel, if any: the embedded wallet it signs with, per-order and daily caps, what remains today, allowed order kinds, and whether the Epsilon signer is actually granted on the wallet. Call it before placing to know whether an order will be placed immediately or need an approval link. Grants are created and revoked by the user in the Epsilon app, never by a tool.

Takes no parameters.

get_market_stats

Market Stats

Market-level numbers for Epsilon (Robinhood Chain DEX). scope=overview (default) is the best first call: top tokens by 30-day volume, 24h volume, and engine-wide order/fill stats in one response. scope=engine returns only order counts by status, fill counts and volume aggregates; scope=volume returns per-token and total swap volume over window. For one token use search_tokens; for executed trades use list_fills.

Parametersscopewindow

get_me

Who Am I

The signed-in Epsilon account behind this session: account id, handle, linked wallets (embedded first), the scopes this client was granted, and which client is connected. Call it first after sign-in to learn the wallet address other tools need. Requires an OAuth session (connect to /mcp/account); on the keyless /mcp endpoint it explains how to sign in instead.

Takes no parameters.

get_order

Get Order Status

One Epsilon order by hash: status (pending/active/filled/cancelled/expired), parameters, and its fills. Use list_orders to find orders by wallet first; use get_orderbook for the market's resting orders on a pair.

ParametersorderHashrequired

get_orderbook

Get Orderbook

The market's open (pending/active) limit orders on both sides of a token pair, largest first — liquidity you can rest against. For one wallet's own orders use list_orders instead.

ParameterstokenArequiredtokenBrequired

get_quote

Get Quote

Best executable quote for swapping tokenIn → tokenOut on Epsilon (Robinhood Chain, id 4663): expected output and price. Use this for a quick price check; use get_route when you need the venue split, fee legs or minimum output for an order you will sign. Amounts are RAW token units — scale by the token's decimals first. Never executes.

ParameterstokenInrequiredamountInrequiredtokenOutrequired

get_route

Get Swap Route

Full routing breakdown for a swap: best venue split, expected and minimum output, price impact (ppm), and the feeLegs a signed order must embed (pass orderType for a resting order so the right fee cell is served). Use get_quote for a plain price; use check_order to learn whether a resting order would be executable at all. Read-only. Amounts are RAW token units.

ParameterswallettokenInrequiredamountInrequiredtokenOutrequiredorderTypetriggeredslippageBps

list_examples

List Code Examples

List runnable Epsilon integration examples (Python cron DCA, LangChain tools, Vercel AI SDK tools, Telegram bot). Fetch full source with get_example. No API key required.

Takes no parameters.

list_fills

Recent Swaps

Executed trades (swaps and order fills) on Epsilon, newest first, optionally for one wallet — the trade history. For resting/open orders use list_orders. Amounts are RAW token units.

Parameterslimitwallet

list_orders

List Orders

A wallet's Epsilon orders filtered by status and/or type — the portfolio view, newest first. Use get_order for one order's fills; use list_fills for executed trades.

Parameterstypelimitstatuswallet

place_dca_order

Place DCA Order (needs approval)

Ask the user to approve a DCA program: sell amount of tokenIn for tokenOut in `executions` equal slices, one every `every` (15m, 1h, 1d…). Optionally gated by triggerPrice (only sells at or below it). Keeper-executed after signing; always returns an approval link — DCA is never executed under an agent grant. HUMAN units; amount is the TOTAL.

ParametersnoteeveryrequiredamountrequiredtokenInrequiredtokenOutrequiredexecutionsrequiredslippageBpstriggerPricepauseOnRecovery

place_limit_order

Place Limit Order (needs approval)

Place a resting limit order: sell amount tokenIn for tokenOut once the market reaches limitPrice (tokenOut per tokenIn) or better. Keeper-executed — it keeps working with the chat closed. If the user granted this client an agent grant and the order fits its caps, it is queued with a stable requestId (status reserved or submitted); otherwise you get an approval link the user signs in the Epsilon app (status needs_approval). Run check_order first. For a protective sell below the market use place_stop_order; for an immediate swap use place_market_order. HUMAN units.

ParametersnoteamountrequiredtokenInrequiredtokenOutrequiredexpiresInrequestIdlimitPricerequiredslippageBps

place_market_order

Place Market Order (needs approval)

Ask the user to approve a market swap of amount tokenIn → tokenOut at the best current route. Returns an approval link, not a fill: the user signs in the Epsilon app. Use get_quote first to tell the user what to expect. For a price-conditional order use place_limit_order or place_stop_order. Amounts are HUMAN units.

ParametersnoteamountrequiredtokenInrequiredtokenOutrequiredslippageBps

place_stop_order

Place Stop Order (needs approval)

Place a stop-loss: sell amount tokenIn for tokenOut if the price falls to triggerPrice (tokenOut per tokenIn). Keeper-executed. Queued under an active agent grant that covers it, otherwise returns an approval link (status needs_approval). Use place_limit_order to sell ABOVE the market (take profit); this tool is for protection BELOW it. Autonomous stops enforce a signed minimum and may remain unfilled after a price gap. HUMAN units.

ParametersnoteamountrequiredtokenInrequiredtokenOutrequiredrequestIdslippageBpstriggerPricerequired

place_trailing_order

Place Trailing Stop (needs approval)

Ask the user to approve a trailing stop: sell amount tokenIn for tokenOut when price drops trailPercent below its running high since placement. Keeper-executed after signing; always returns an approval link — trailing stops are never executed under an agent grant. For a fixed level use place_stop_order. HUMAN units.

ParametersnoteamountrequiredtokenInrequiredtokenOutrequiredexpiresInslippageBpstrailPercentrequired

search_docs

Search Docs

Search the Epsilon developer documentation (API, auth, order signing, webhooks, rev-share, SDKs, MCP). Returns the most relevant doc sections. No API key required.

Parameterslimitqueryrequired

search_tokens

Search Tokens

Resolve a token symbol or name to its address and decimals — call this FIRST when the user names a token; every other tool takes addresses. volume30dUsd disambiguates same-symbol tokens: the real one has volume.

Parameterslimitsearch

Version history

3
  1. v0.4.0LatestOct 5, 2026
  2. v0.3.0Sep 17, 2026
  3. v0.2.2Sep 16, 2026

Score

75% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • License10 pts

    Declare a license in the repository or the registry entry.