Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

Felix MCP

NPM · FELIX-MCP

Non-custodial trading infrastructure for AI agents across prediction markets, crypto, and options.

Available components

+3 this week 79 Trust /100

Last scanned (22 hours ago)

Scores higher than 63% of npm servers

Category Finance and Payments

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 35 of 123 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency19
Schema Quality & AI Usability81
  • 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).Pass
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 26422 tokens (~129/item across 204 items; 197 tools + 7 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management97
  • Stability check failed: the tool surface changed between 2.0.110 and 2.0.133: 1 tool removals, 6 breaking changes, 73 additions. See how to fix → Fail
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 13 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 198 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (15)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Security disclosure in Provenance & TransparencySecurity-disclosure policy not yet verified: we couldn't inspect the source repository.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 20 Nov 26 +25
    • Malware scan: unverified → pass ▲ security
    • Known CVEs: unverified → pass ▲ security
    • Dependency health: unverified → 0.87 ▲ functional
  • 19 Nov 26 −11
    • Known CVEs: pass → unverified ▼ security
    • Malware scan: unverified → pass ▲ security
    • Dependency health: 0.87 → unverified ▼ functional
    • Package version: 2.0.132 → 2.0.133 functional
  • 18 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
    • Package version: 2.0.129 → 2.0.132 functional
  • 17 Nov 26 0
    • Package version: 2.0.128 → 2.0.129 functional
  • 16 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 15 Nov 26 −11
    • Known CVEs: fail → unverified ▼ security
    • Malware scan: pass → unverified ▼ security
    • Stability: pass → fail ▼ security
    • CVE-2026-101900 no longer affects this package ▲ security
    • CVE-2026-118663 no longer affects this package ▲ security
    • CVE-2026-101908 no longer affects this package ▲ security
    • CVE-2026-101902 no longer affects this package ▲ security
    • CVE-2026-111767 no longer affects this package ▲ security
    • CVE-2026-101907 no longer affects this package ▲ security
    • CVE-2026-104850 no longer affects this package ▲ security
    • CVE-2026-111768 no longer affects this package ▲ security
    • CVE-2026-111771 no longer affects this package ▲ security
    • CVE-2026-101901 no longer affects this package ▲ security
    • CVE-2026-101898 no longer affects this package ▲ security
    • CVE-2026-101903 no longer affects this package ▲ security
    • CVE-2026-101905 no longer affects this package ▲ security
    • CVE-2026-101909 no longer affects this package ▲ security
    • CVE-2026-101904 no longer affects this package ▲ security
    • CVE-2026-101906 no longer affects this package ▲ security
    • CVE-2026-111769 no longer affects this package ▲ security
    • CVE-2026-101899 no longer affects this package ▲ security
    • GHSA-f897-62hf-6gxq no longer affects this package ▲ security
    • Known CVEs: fail → pass ▲ security
    • Dependency health: 0.88 → unverified ▼ functional
    • Schema quality: pass → fail ▼ functional
    • Package version: 2.0.110 → 2.0.128 functional
    • Package version: 2.0.110 → 2.0.123 functional
  • 12 Nov 26 0
    • Stability: 0.97 → pass security
  • 11 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.

Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/felix-mcp@2.0.133

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Dependencies 123 packages
Packages resolved 123
Stale 35
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 197 exposed · ~26,261 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
add_withdrawal_address ~101

Authorize a withdrawal address immediately. Felix prepares the exact destination, signs it with the local owner key, and activates it in one call; there is no waiting period and the key never leaves this process.

NameTypeReqDescription
account_idstring–Optional owned child account UUID. Reload the launcher key before targeting a child.
addressstringyes0x Polygon address to allowlist.
chainstring–Chain. Defaults to polygon.

No output schema declared.

No examples provided.

agent_status ~35

Status, run count, PnL, and last decision for one deployed agent.

NameTypeReqDescription
agent_idstringyesAgent UUID.

No output schema declared.

No examples provided.

apply_fleet_reallocation ~176

Rebuild a reviewed fleet plan from fresh owner-scoped state, then atomically change only eligible paused agents' budget ceilings. Requires the policy version from preview_fleet_reallocation and a stable idempotency key. Never resumes agents, moves or reserves money, funds venues, changes positions, or submits orders.

NameTypeReqDescription
account_idstring–Optional owned child account UUID. Omit for the active account.
agent_weightsarrayyesExact reviewed split across every active owned agent, totaling 10000 basis points.
expected_policy_versionintegeryesPortfolio mandate version returned by the reviewed preview.
idempotency_keystringyesStable retry-safety key for this exact fleet update.
target_deployed_capital_usdnumberyesExact reviewed total live-capital target across the fleet.

No output schema declared.

No examples provided.

approve_polymarket_wallet ~88

Locally sign and relay only the fixed pUSD/CTF exchange approval batch for the caller-owned deposit wallet. Requires FELIX_OWNER_PRIVATE_KEY in single-user stdio mode.

NameTypeReqDescription
dry_runboolean–Read approval state without signing or submitting a relayer operation.
idempotency_keystring–Optional retry-safety key for preparation. Auto-generated when omitted.

No output schema declared.

No examples provided.

arc_home_deposit ~247

Move the owner's USDC from another chain into this account's verified Arc home Safe through Circle Gateway, in one resumable owner-signed call. Felix tops up only the shortfall in the owner's Gateway balance: the owner broadcasts that approval and Gateway deposit through your own FELIX_<CHAIN>_RPC_URL (owner-paid source gas), signs the burn intent, and signs the Arc mint SafeTx; Felix pays the Arc mint gas. A direct Arc deposit needs no call: send Arc USDC only to the verified arc.address from get_deposit_address. Not live-certified on this release.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
amount_usdnumberyesUSDC to credit into the Arc home Safe, at most six decimals.
idempotency_keystringyesRequired durable workflow key. Reuse it after any timeout or restart.
max_fee_usdnumber–Owner-paid Circle Gateway fee ceiling. Defaults to 0.05.
resume_reconciliationboolean–Set true only to resume this exact interrupted deposit after reading its operation.
source_chainstringyesSource chain holding the owner's USDC.

No output schema declared.

No examples provided.

arc_home_fund_venue ~344

LEGACY: for accounts that still have a Polygon owner wallet record. A new account funds Polymarket with fund_polymarket_from_arc and Hyperliquid with fund_hypercore_from_arc instead (this tool answers arc_home_venue_wallet_unavailable for them). Stages Polymarket funding from the Arc home Safe: an owner-signed Circle Gateway withdrawal whose destination Felix resolves to this account's own Polygon owner wallet (the client refuses any other destination before signing). Completion is native USDC in the Polygon owner wallet, NOT Polymarket collateral: the result sets venue_funded=false and returns next_action fund_market(venue=prediction_market), a separate owner-signed call. Hyperliquid and Derive are refused before anything is prepared. Not live-certified on this release.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
amount_usdnumberyesUSDC to deliver to the Polygon owner wallet, at most six decimals.
idempotency_keystringyesRequired durable workflow key. Reuse it after any timeout or restart.
max_fee_usdnumber–Owner-paid Circle Gateway fee ceiling. Defaults to 0.05.
resume_reconciliationboolean–Set true only to resume this exact interrupted funding operation.
submit_destination_mintboolean–Also broadcast the final Polygon mint into the owner wallet with the owner key through your own FELIX_POLYGON_RPC_URL. Defaults to true; that gas is owner paid.
venuestringyesDestination venue. Only polymarket is supported by this tool; for Hyperliquid use fund_hypercore_from_arc.

No output schema declared.

No examples provided.

arc_home_hypercore_return ~321

Return 5 to 25 USDC from the owner's OWN Hyperliquid (HyperCore) perps balance directly to the account's verified Arc home Safe via Relay: no Arbitrum and no withdraw3. The owner's HyperCore account must be in default mode and hold the amount as withdrawable. Before signing, the client verifies the solver-signed Relay order (HyperCore perps USDC in, exactly one Arc USDC payment to this Safe at or above a 1% floor, refunds only to the owner on HyperCore and the Safe on Arc), then builds and signs locally exactly two payloads: the Relay nonce mapping and one HyperCore sendAsset of the amount to Relay's pinned depository at the same nonce. Both are journaled before Felix submits them. Completion requires Felix's completion bound to this order and solver, and this client's own HyperCore ledger read of the send (the Arc credit is Felix's evidence, bound to the signed order and bounds, as in the app). No Felix fee is charged on this route. Reuse the same idempotency_key after a timeout; never start a new return to work around an uncertain one.

NameTypeReqDescription
amount_usdnumberyesExact USDC to send from HyperCore perps, 5 to 25, at most six decimals.
idempotency_keystringyesRequired workflow replay key. Reuse it to resume this exact return.
minimum_credit_usdnumber–Optional: refuse unless Relay signs at least this Arc credit.

No output schema declared.

No examples provided.

arc_home_withdraw ~379

Withdraw USDC out of this account's verified Arc home Safe in one resumable owner-signed call. chain=arc is a same-chain Safe transfer with no Circle fee (Felix pays the Arc gas). chain=base|polygon|arbitrum|ethereum goes through Circle Gateway: the owner pays the Gateway fee ceiling and the destination-chain mint gas. The destination must be the owner's own address or a Felix-allowlisted address on that chain (add_withdrawal_address allowlists Polygon). Every SafeTx and burn intent is verified against this exact request before it is signed locally; a mismatch refuses without a signature. Not live-certified on this release.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
amount_usdnumberyesUSDC to deliver to the destination, at most six decimals.
chainstringyesDestination chain.
idempotency_keystringyesRequired durable workflow key. Reuse it after any timeout or restart.
max_fee_usdnumber–Owner-paid Circle Gateway fee ceiling for a cross-chain withdrawal. Defaults to 0.05; must be 0 for chain=arc.
resume_reconciliationboolean–Set true only to resume this exact interrupted withdrawal after reading its operation.
submit_destination_mintboolean–For a cross-chain withdrawal to the owner's own address, also broadcast the final mint with the owner key through your own FELIX_<CHAIN>_RPC_URL. Defaults to true; the mint gas is owner paid.
tostringyesExact destination: the owner address, or an address allowlisted for that chain.
withdrawal_confirmationobject–Email-confirmation proof for this exact withdrawal, returned by /v1/withdraw/confirmation/verify. Required by the engine for a new withdrawal preparation.

No output schema declared.

No examples provided.

archive_account ~73

Owner-pause and archive a flat child account, revoke every child key, and retain wallet and financial records for audit.

NameTypeReqDescription
account_idstringyesOwned child account UUID.
confirm_account_idstringyesMust exactly repeat account_id.
idempotency_keystringyesRequired stable archive workflow key.

No output schema declared.

No examples provided.

backtest ~212

Backtest an owned Felix-generated strategy by strategy_id on real historical data. Returns the chart-ready summary and replay attestation by default. Use start_backtest for large histories. User-supplied code is refused.

NameTypeReqDescription
barsinteger–Historical bars; interval-specific limits apply and are validated locally.
capitalnumber–Starting capital.
detailstring–summary (default) or full raw result.
idempotency_keystring–Optional retry-safety key. Reuse the exact key after an interrupted synchronous request.
intervalstring–1m|5m|15m|1h|4h|1d
marketsarray–Optional instruments/markets, max 4.
namestring–Display name, max 80 characters.
strategy_idstringyesOwned strategy UUID returned by generate_strategy.
yearsnumber–Historical years. Overrides bars; use interval=1d for up to 40 years.

No output schema declared.

No examples provided.

backtest_sensitivity ~193

Replay one exact strategy across two to eight explicit history, capital, fee, and slippage scenarios using one shared price dataset. This bounded diagnostic never changes strategy code and never signs, funds, deploys, or trades.

NameTypeReqDescription
idempotency_keystringyesRequired stable retry key. Reuse it after any timeout.
intervalstring–Bar interval. Defaults to 1h.
marketstringyesOne canonical instrument shared by every scenario.
min_tradesinteger–Minimum clean trades required in every scenario before robustness can pass. Incomplete history, unreplayed live-only inputs, degraded or short execution, or any non-positive scenario also force robus…
scenariosarrayyesTwo to eight bounded scenarios on the same immutable dataset end.
strategy_idstringyesOwned strategy UUID returned by generate_strategy.
venuestring–Optional market-class hint.

No output schema declared.

No examples provided.

bring_home ~221

Legacy owner-wallet return workflow, still under certification; it may stop at an intermediate owner wallet. For allocated Hyperliquid, Lighter or Polymarket capital returning to Arc Home, use preview_capital_move then start_capital_move(direction=bring_home), and get_capital_move for reconciliation. Retain the original ID, key and hashes for an interrupted legacy operation; never use a new key to bypass an uncertain result.

NameTypeReqDescription
allow_high_fee_lossboolean–Crypto only: accept a high proportional route cost if the selected provider requires it. Never enabled by default.
amount_usdnumber–Amount to return. Omit to sweep the full spendable prediction-market balance.
idempotency_keystringyesRequired workflow replay key. Reuse it after any timeout or restart.
resume_reconciliationboolean–Crypto only: with a fresh workflow key, resume a prior confirmed venue withdrawal only when the owner-held Arbitrum balance matches the bounded post-fee amount.
venuestringyesSource market account.

No output schema declared.

No examples provided.

calculate_position_size ~110

Calculate a portfolio-constrained position size from the applied server mandate. No order is placed. A separate preview_order call is still required for venue economics and liquidity.

NameTypeReqDescription
account_idstring–Optional owned child account UUID. Omit for the active account.
instrument_volatility_pctnumber–Annualized instrument volatility; required for volatility_target.
invalidation_distance_pctnumberyesAdverse move at which the thesis is invalidated.
methodstringyesSizing method.

No output schema declared.

No examples provided.

cancel_deposit ~65

Close an unpaid deposit instruction from create_deposit. Refused once any payment was seen. Moves no money.

NameTypeReqDescription
account_idstring–Optional owned child account UUID. Omit for the active account.
request_idstringyesrequest_id from create_deposit.

No output schema declared.

No examples provided.

cancel_exit_plan ~49

Cancel an armed exit plan. A plan already triggering cannot be cancelled.

NameTypeReqDescription
idempotency_keystringyesRequired retry-safety key.
position_idstringyesOwned position UUID.

No output schema declared.

No examples provided.

cancel_open_order ~46

Cancel one live resting order by its id from list_open_orders. Reduces risk; never opens anything.

NameTypeReqDescription
order_idstringyesResting order id from list_open_orders.

No output schema declared.

No examples provided.

cancel_order ~71

Cancel a live resting order (Hyperliquid, Lighter or Polymarket; same as cancel_open_order) by its order id from list_open_orders. Filled paper orders are not cancellable; close the returned position_id instead.

NameTypeReqDescription
order_idstringyesResting order id from list_open_orders.

No output schema declared.

No examples provided.

cancel_position_protection ~54

Remove a position's take-profit and stop-loss. Pass the current version from get_position_protection.

NameTypeReqDescription
position_idstringyesPosition id.
versionintegeryesCurrent version from get_position_protection.

No output schema declared.

No examples provided.

cancel_withdrawal ~162

UNAVAILABLE: Felix cannot cancel a submitted withdrawal, and this tool refuses up front rather than pretending to. It spends no gas, signs nothing and moves no money. A broadcast Polygon transfer is final: wait for it to confirm and reconcile with get_money_map, get_balances and list_recent_operations, or reconcile the owner nonce with support if it is stuck. Never submit a replacement transfer at a fresh nonce.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
capital_operation_idstringyesOriginal capital operation UUID.
idempotency_keystringyesRequired cancellation workflow key. Reuse the exact key after interruption.
transaction_hashstring–Optional known zero-value cancellation hash: verify it without signing or sending anything.

No output schema declared.

No examples provided.

close_manual_position ~141

Close a manual position fully, or partly with size_usd or percent (Hyperliquid, Lighter, Polymarket), with a reduce-only market order. Read the result with get_close_receipt using the same idempotency_key.

NameTypeReqDescription
idempotency_keystring–Retry-safety key; reuse it to read the receipt. Auto-generated when omitted.
percentnumber–Close this percent of the position, 1-100 (omit for a full close).
position_idstringyesPosition id from get_positions.
size_usdnumber–Close this USD notional (omit for a full close).

No output schema declared.

No examples provided.

close_position ~77

Close a caller-owned position by id. Derive closes use a durable asynchronous operation and bounded polling; never resubmit a pending close with a new key.

NameTypeReqDescription
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.
position_idstringyesUUID position id returned by place_order or get_positions.

No output schema declared.

No examples provided.

close_support_ticket ~56

Close a caller-owned support ticket. This does not delete its encrypted audit thread.

NameTypeReqDescription
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.
ticket_idstringyesSupport ticket UUID.

No output schema declared.

No examples provided.

complete_hyperliquid_onboarding ~105

Submit the main wallet's exact approveAgent signature and verify the scoped API-wallet relationship on Hyperliquid.

NameTypeReqDescription
account_idstring–Optional caller-owned Felix subaccount UUID.
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.
onboarding_idstringyesHyperliquid onboarding UUID.
signaturestringyes65-byte EIP-712 signature from the stated Hyperliquid main wallet.

No output schema declared.

No examples provided.

complete_wallet_onboarding ~172

RETIRED: Polygon Safe wallets are retired and Felix answers 410 polygon_safe_hub_retired; every account's wallet is its Arc home Safe (fund it with create_deposit; stop all trading with panic). Verify and relay the owner's locally validated exact Safe module-enable and fallback-handler signatures, then link the client-owned wallet. Follow felix://getting-started.

NameTypeReqDescription
account_idstring–Optional child account UUID.
enable_signaturestringyes0x-prefixed 65-byte canonical Safe signature.
fallback_signaturestringyes0x-prefixed 65-byte canonical signature for the returned fallback_safetx.
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.
onboarding_idstringyesOnboarding UUID.

No output schema declared.

No examples provided.

confirm_withdrawal_address ~69

Re-authorize a legacy withdrawal-address entry immediately with the local owner key. New addresses need only add_withdrawal_address.

NameTypeReqDescription
account_idstring–Optional owned child account UUID. Reload the launcher key before targeting a child.
addr_idstringyesWithdrawal address UUID.

No output schema declared.

No examples provided.

create_account ~526

Create a real-money Felix account, like app.felix.trade. The first call reserves one isolated identity, binds its owner, and (until the account's Arc home holds the $5 minimum) returns account_funding_required with deposit_flow: pay with create_deposit, then retry the exact same idempotency_key; it never hands out a Polygon address. Felix then sets up and verifies the Arc home Safe/module, signs the account owner's trading policy locally (the app's device trading policy: no risk limits, Hyperliquid fast-custody trade keys, and Lighter Premium with Felix partner fees, returned in trading_policy), and mints a live key. The $5 deposit does not fund a first live trade: fund the venue with fund_hypercore_from_arc or fund_polymarket_from_arc. No prepaid fee credit is needed; Felix's fee is charged after each fill. Emits progress every 15 seconds. Requires the registered local owner signer and launcher manage key. Cold start: felix://getting-started.

NameTypeReqDescription
accept_termsbooleanyesMust be true to confirm acceptance of Felix Terms of Service, Privacy Policy, and Risk Disclosure.
accept_trading_policyboolean–Only after the owner answered yes to the trading_policy_question this tool returned.
delegation_daysinteger–Delegation duration in days. Defaults to 30; maximum 90.
emailstring–Optional new email for the isolated child. Omit to generate an internal identity.
idempotency_keystringyesStable account-creation key. Reuse the exact value after any interruption.
labelstring–Optional account/live-key label.
legal_versionstring–Current Felix legal bundle version. Omit to use the version bundled with this MCP build.
lifetime_limit_usdnumber–Optional Safe delegation lifetime safety ceiling. Defaults/maxes at $1B.
max_daily_loss_usdnumber–Optional owner-authorized daily loss safety ceiling. Defaults/maxes at $100M.
max_daily_usdnumber–Optional owner-authorized daily notional safety ceiling. Defaults/maxes at the account's $100M daily limit.
max_order_usdnumber–Optional owner-authorized per-order safety ceiling. Defaults/maxes at the account's $10M operation limit.
resume_reconciliationboolean–Set true only to resume this exact workflow after inspecting an interrupted attempt.
trading_policy_terms_idstring–The trading_policy_terms_id from that question.

No output schema declared.

No examples provided.

create_deposit ~203

Get a one-time payment address for a deposit into the account's Arc home, the same Relay deposit app.felix.trade uses (also a brand-new account's first deposit before its Arc home is set up). Pay exactly from_amount of from_currency on that token's own network before the window ends; it arrives as USDC in the Arc home Safe, which this client re-derives from the owner key and checks before showing any address. Moves no money itself. A first deposit must deliver at least $5.

NameTypeReqDescription
account_idstring–Optional owned child account UUID. Omit for the active account.
from_amountnumberyesAmount of from_currency you will send.
from_currencystringyesDeposit token key from get_deposit_address list_currencies, for example usdc_base.
idempotency_keystringyesRequired. Reuse it after a timeout to get the same instruction back, never a second one.

No output schema declared.

No examples provided.

create_referral ~67

Create or fetch a referral code/rev-share link for the caller.

NameTypeReqDescription
labelstring–Optional label/source, up to 60 characters.
rev_share_bpsinteger–Referral rev-share in basis points, from 0 to 100. Defaults to 20.

No output schema declared.

No examples provided.

create_support_ticket ~135

Open an encrypted two-way Felix support ticket. The ticket is account-scoped, idempotent, rate-limited, and readable only by this account and Felix support.

NameTypeReqDescription
categorystring–Problem area. Defaults to support.
contextobject–Optional diagnostic identifiers only; never include secrets.
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.
messagestringyesProblem description, 10-4000 characters.
severitystring–Severity. Defaults to medium.
subjectstringyesShort problem summary, 4-160 characters.

No output schema declared.

No examples provided.

create_webhook ~125

Create an HTTPS webhook for fills/positions/agent events. Returns signing_secret once.

NameTypeReqDescription
eventsarray–Events: order.filled, position.opened, position.closed (every live close: app, agent, take-profit/stop-loss, liquidation, market resolution; close_reason is liquidation, market_resolved or null), pos…
idempotency_keystring–Optional stable retry key. Reuse it after an interrupted registration.
urlstringyesPublic HTTPS URL. No localhost/private IPs.

No output schema declared.

No examples provided.

delete_webhook ~26

Delete a webhook by id.

NameTypeReqDescription
webhook_idstringyesWebhook UUID.

No output schema declared.

No examples provided.

deploy_agent ~689

Deploy an owned Felix-generated strategy by strategy_id as a live agent by default. markets binds every open to one of 1-4 owner-selected instruments and should match the backtest. Stop loss and other server-monitored exits are optional on Hyperliquid and Derive; omit them to let the strategy manage exits. Polymarket does not support server exit plans, so omit those fields and let the strategy or market resolution close exposure. If a requested supported exit plan cannot be armed after a fill, Felix pauses and attempts a reduce-only unwind. Hyperliquid leverage is blocked unless allow_leverage:true is explicit. Set mode:paper explicitly to simulate. Live supports Hyperliquid, Derive, and Polymarket through venue-scoped execution signing. A Polymarket binding such as btc-updown-5m authorizes only its current timestamped child. See felix://strategy/ctx-api for the think(ctx) contract. Pass idempotency_key to make a retry safe.

NameTypeReqDescription
acknowledge_unvalidatedboolean–Explicitly acknowledge missing or degraded replay evidence when deploying live.
allow_leverageboolean–Explicitly permit a live Hyperliquid perp agent to exceed free collateral. Omitted or false blocks leveraged exposure before signing.
break_even_after_pctnumber–Optional profit fraction that activates a break-even exit.
budget_usdnumberyesExplicit agent capital budget.
confirmed_budget_usdnumber–Required for live mode only: USD capital reviewed by the owner; must match budget_usd at cents. Never derive this confirmation from a generic yes.
cycle_secondsnumber–Loop interval. Polymarket supports 5-86400 seconds; other venues support 30-86400 seconds.
idempotency_keystring–Optional retry-safety key. Reuse it to recover an interrupted deployment without creating a second agent.
marketsarrayyesOne to four owner-authorized instruments. Every live open outside this list fails before signing.
max_daily_loss_usdnumber|null–Explicit daily-loss ceiling. Omit or use null for no selected agent limit; live key caps still apply.
max_holding_minutesnumber–Optional maximum position age in minutes.
max_position_usdnumber|null–Explicit position ceiling. Omit or use null for no selected agent limit; live key caps still apply.
modestring–paper|live. Defaults to live; set paper explicitly to simulate.
namestring–Agent name.
promptstring–Optional source prompt for audit/history.
replay_attestationstring–Replay attestation token returned by backtest for this exact strategy.
stop_loss_pctnumber–Optional server-monitored hard-stop loss fraction for Hyperliquid and Derive agents, e.g. 0.05 for 5%. Omit it to run without a server stop.
strategy_idstringyesOwned strategy UUID returned by generate_strategy.
take_profit_pctnumber–Optional server-monitored profit target fraction.
trailing_activation_pctnumber–Optional profit fraction before the trailing stop arms.
trailing_stop_pctnumber–Optional server-monitored trailing distance fraction.
venuestring–Optional preferred venue, e.g. hyperliquid, polymarket.

No output schema declared.

No examples provided.

deploy_polymarket_wallet ~66

Deploy the caller-owned Polymarket deposit wallet without sending an owner key or signature to Felix.

NameTypeReqDescription
dry_runboolean–Read deployment state without deploying or spending gas.
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.

No output schema declared.

No examples provided.

deploy_wallet_onboarding ~149

RETIRED: Polygon Safe wallets are retired and Felix answers 410 polygon_safe_hub_retired; every account's wallet is its Arc home Safe (fund it with create_deposit; stop all trading with panic). Verify the owner's locally validated personal-sign challenge and activate the Safe policy wallet. Accepts a signature, never the owner key. Follow felix://getting-started.

NameTypeReqDescription
account_idstring–Optional child account UUID.
idempotency_keystring–Optional retry-safety key. Auto-generated when omitted.
onboarding_idstringyesOnboarding UUID.
proof_signaturestringyes0x-prefixed 65-byte owner proof signature.

No output schema declared.

No examples provided.

derive_api_key ~217

Explicit paper-mode helper. Requires a registered local launcher identity plus paper:true, then creates an isolated zero-fund sandbox with a least-privilege paper key. For cold start read felix://getting-started; for real money use create_account.

NameTypeReqDescription
accept_termsbooleanyesMust be true to confirm acceptance of Felix Terms of Service, Privacy Policy, and Risk Disclosure.
activateboolean–Switch this local MCP session to the derived key without exposing it. Raw key export is disabled.
emailstring–Optional new email for the isolated child. Omit to generate a fresh internal child identity.
idempotency_keystring–Optional stable retry key for this account creation. Reuse it after a timeout.
labelstring–Optional label, max 80 chars. Defaults server-side.
legal_versionstring–Current Felix legal bundle version. Omit to use the version bundled with this MCP build.
paperbooleanyesRequired explicit simulation selection. Must be true.

No output schema declared.

No examples provided.

fund_hypercore_from_arc ~537

Move 5 to 25 USDC from the account's verified Arc home Safe directly to the SAME owner's Hyperliquid (HyperCore) perps balance via Relay. The Safe must also hold a separate 1.00 USDC Felix network fee: principal plus fee are paid atomically in the same owner-signed transaction. This fee is not refunded if Relay later returns the principal. Relay's quoted deduction is separately limited to 1% of principal; that limit excludes the Felix fee. A brand-new HyperCore account (none exists yet for the owner) also pays Hyperliquid's one-time account activation fee, passed on by Relay (about 1.20 USDC, at most 1.5), deducted from this funding's HyperCore credit, not from the Safe; later fundings do not pay it. It is never accepted automatically: without accept_activation_cost_usd such a funding is refused before anything is prepared, naming the exact cost and the re-call (with a new idempotency_key) that opts in. Before signing, the client independently verifies the Relay order, solver, fee, exact Safe calls and perps account mode, then journals its signature (the Safe nonce comes from Felix, as in the app). After verified perps credit with Relay-attested attribution, the local owner signer completes Hyperliquid trading-agent approval if needed; completed includes hyperliquid_status:ready. If funding succeeds but approval does not, venue_funded:true and venue_usable:false mean resume this same idempotency_key and arguments to finish approval without another funding transfer. Reuse the same idempotency_key after a timeout; never create a new funding to work around an uncertain outcome.

NameTypeReqDescription
accept_activation_cost_usdnumber–Optional, owner opt-in: the most the owner accepts (USDC, more than 0 and at most 1.5, at most six decimals) for Hyperliquid's one-time activation of a HyperCore account that does not exist yet, dedu…
amount_usdnumberyesExact transfer principal, 5 to 25 USDC, at most six decimals. Excludes the additional 1.00 USDC Felix fee.
idempotency_keystringyesRequired workflow replay key. Reuse it to resume this exact funding.
minimum_credit_usdnumber–Optional: refuse unless Relay signs at least this perps credit.

No output schema declared.

No examples provided.

fund_market ~264

Route funds from the client-owned main EOA to a currently certified venue. Prediction-market and crypto funding are available; Derive/options funding is under release hold and must not be started. Native Polygon USDC is converted to USDC.e only as needed, with hashes disclosed. The owner key signs locally and never reaches Felix.

NameTypeReqDescription
account_idstring–Target a specific child account (UUID) instead of the launcher's default account. The child owner key is derived locally; it never reaches Felix.
amount_usdnumberyesAmount to fund.
auto_swap_native_usdcboolean–Automatically convert only the native Polygon USDC needed for this funding operation. Defaults to true; set false to require a separate explicit swap.
idempotency_keystringyesRequired workflow replay key. Reuse it after any timeout or restart.
minimum_receive_usdnumber–Optional minimum final venue credit. The route fails closed before submission when its bounded quote cannot satisfy this floor.
resume_reconciliationboolean–Set true only after inspecting the original workflow and its submitted hashes. Reuses saved checkpoints and the original idempotency_key; never starts a second fee payment or venue transfer.
venuestringyesTarget market account.

No output schema declared.

No examples provided.

fund_polymarket_agent_wallet ~136

Set up the caller's distinct venue-scoped autonomous Polymarket wallet, then locally sign one exact pUSD transfer to it. Felix cannot redirect the destination and never receives the owner key. Use this before deploying a live Polymarket agent; direct client-signed orders continue using the client-owned wallet.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
amount_usdnumberyesExact pUSD amount to transfer from the client-owned Polymarket wallet to the autonomous agent wallet.
idempotency_keystringyesRequired durable workflow key, 1-128 printable ASCII characters.

No output schema declared.

No examples provided.

fund_polymarket_from_arc ~251

Fund Polymarket from the account's Arc home, exactly like app.felix.trade: move 5 to 25 USDC from the verified Arc home Safe to the SAME owner's Polygon wallet via Relay, then into the account's own Polymarket wallet as pUSD. The Safe must also hold a separate 1.00 USDC Felix network fee, paid atomically in the same owner-signed transaction; it is not refunded if Relay later returns the principal. Before signing, the client verifies the Relay order, solver, amounts, refunds and the exact Safe calls, then journals its signature. Select the account with use_child_account first. Reuse the same idempotency_key after a timeout; never start a new funding to work around an uncertain outcome.

NameTypeReqDescription
amount_usdnumberyesExact transfer principal, 5 to 25 USDC, at most six decimals. Excludes the additional 1.00 USDC Felix fee.
idempotency_keystringyesRequired workflow replay key. Reuse it to resume this exact funding.
minimum_credit_usdnumber–Optional: refuse unless Relay signs at least this Polygon USDC.e credit.

No output schema declared.

No examples provided.

generate_strategy ~96

Generate a Felix-written strategy from plain words. Returns strategy_id for backtests and deployment; returned source is for display only and must never be sent back. Uses the account's generation budget.

NameTypeReqDescription
idempotency_keystring–Optional stable retry key. Auto-generated when omitted; reuse after a timeout.
promptstringyesStrategy idea in plain words, under 4000 characters. User-supplied code is refused.

No output schema declared.

No examples provided.

get_account_statement ~94

Stable, owner-scoped trade ledger for reconciliation and exports. Follow next_cursor until null. Rows label live, paper, and live-mock activity explicitly and disclose missing historical fee or PnL fields. This is not a tax statement and never moves money.

NameTypeReqDescription
cursorstring–Opaque next_cursor from the previous page.
limitinteger–Maximum trade rows in this page. Defaults to 100.

No output schema declared.

No examples provided.

get_agent_capital ~57

Read the account's allocated trading capital, venue balances, transfer availability and recent moves, including Lighter. Home is the owner's Arc Safe. No signing or transfer occurs.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.

No output schema declared.

No examples provided.

get_agent_log ~82

Read a caller-owned agent's durable decision log, including each decision, runtime outcome, block/error reason, market snapshot, and latency.

NameTypeReqDescription
agent_idstringyesAgent UUID.
beforestring–Optional ISO-8601 cursor returned as next_before.
limitinteger–Maximum decisions, 1-100. Defaults to 50.

No output schema declared.

No examples provided.

get_arc_home_operation ~80

Read one Arc home operation (withdrawal, deposit, or venue staging) with its phase, amounts, fee payer, transaction hashes and next_action. A pure read; call reconcile_arc_home_operation when next_action is reconcile.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
operation_idstringyesArc home operation UUID.

No output schema declared.

No examples provided.

get_arc_transfer ~97

Read one Felix Arc settlement journey by its settlement operation id. By default it runs the owner-scoped reconcile step, which advances bookkeeping from chain and Circle evidence without moving money; set reconcile:false for a plain read.

NameTypeReqDescription
operation_idstringyesSettlement operation id (UUID) from prepare_arc_transfer or the operation field of a submit_arc_transfer result.
reconcileboolean–Run the reconcile step before reading. Defaults to true.

No output schema declared.

No examples provided.

get_available_to_trade ~58

Available to trade for one market right now (venue collateral plus what the Trading wallet and Home can fund), exactly as the app's ticket shows it.

NameTypeReqDescription
instrumentstringyesperp:BTC, lighter:ETH or pm:<slug>.

No output schema declared.

No examples provided.

get_backtest_operation ~42

Read progress or the terminal result for a durable asynchronous backtest without starting another computation.

NameTypeReqDescription
operation_idstringyesOperation id returned by start_backtest.

No output schema declared.

No examples provided.

get_balances ~137

NOT the account total: for the total account value the app shows (and 'how much do I have'), call get_money_map. This is a fast venue collateral snapshot plus Polygon cash and paper position count. Provider gaps are returned explicitly instead of hidden behind retries; set wait_for_complete:true to wait through the bounded Derive refresh cycle. This intentionally excludes marked Polymarket positions and owner-wallet balances on other chains; use get_money_map for canonical account-value and money-tracking decisions.

NameTypeReqDescription
wait_for_completeboolean–Wait through up to two bounded Derive refresh attempts. Defaults to false for a fast, explicitly partial response.

No output schema declared.

No examples provided.

get_capital_move ~99

Read an owned capital move while the engine worker reconciles it. Returns state, steps, errors and transaction hashes. completed is terminal; use get_capital_move_recovery for reconcile_required guidance without resubmission. A timeout is not proof that no money moved. This tool never starts or resubmits a move.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
move_idstringyesEngine capital move UUID.

No output schema declared.

No examples provided.

get_capital_move_recovery ~67

Read recovery guidance for the same owned capital move. GET never retries signing or resubmits. operator_required means contact support with the original ID and hashes.

NameTypeReqDescription
account_idstring–Optional owned child account UUID.
move_idstringyesExisting move UUID.

No output schema declared.

No examples provided.

Install

How do I install the Felix MCP server?

Felix MCP runs locally as an npm package, launched with npx -y felix-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · felix-mcp

# add to Claude Code
claude mcp add trade-felix-mcp -- npx -y felix-mcp
Common questions

What is the Felix MCP server?

Felix MCP is listed in the public MCP registry as trade.felix/mcp. Non-custodial trading infrastructure for AI agents across prediction markets, crypto, and options. This page covers its npm package (felix-mcp).

Is the Felix MCP server safe to use?

Felix MCP scores 79 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the Felix MCP server expose?

Felix MCP exposes 197 tools: get_status, get_health, get_metrics, get_custody_recovery_status, get_strategy_guide, and 192 more. Their descriptions and schemas cost roughly 26,261 tokens of context every time the server is loaded.

Is the Felix MCP server still maintained?

Felix MCP is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the Felix MCP server under?

Felix MCP declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the Felix MCP server?

VerifyMCP ran 15 checks on Felix MCP, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about Felix MCP: Security disclosure. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.