Felix MCP
NPM · FELIX-MCP
Non-custodial trading infrastructure for AI agents across prediction markets, crypto, and options.
Available components
Last scanned (23 hours ago)
Scores higher than 63% of npm servers
Category Finance and Payments
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
- Repository check failed: no source repository is declared. See how to fix → View diagnostics → Fail
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 1 days ago).Pass
- Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
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
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 →
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.
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 →
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 →
init_wallet_onboarding ~241
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). Start advanced client-owned Safe onboarding. The owner key must be generated and retained outside Felix; only public addresses are sent. Read felix://getting-started before implementing the signing flow.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| daily_limit_usd | number | – | Maximum autonomous daily total. Defaults to 500. |
| delegation_days | integer | – | Owner-signed agent delegation lifetime. Defaults to 30 days; maximum 90. |
| home_address | string | – | Optional fixed sweep-home address. Defaults to owner. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| lifetime_limit_usd | number | – | Maximum cumulative autonomous total for this module. Defaults to daily limit multiplied by delegation days. |
| max_operation_usd | number | – | Maximum autonomous operation size. Defaults to 100. |
| owner_address | string | yes | Client-owned EVM address. |
No output schema declared.
No examples provided.
inspect_token_risk ~126
Inspect one exact Solana mint or BNB contract through the optional token API. The engine returns token_evidence_unavailable when required provider evidence is missing. Evidence is read-only, never labels a token safe, and does not authorize execution.
| Name | Type | Req | Description |
|---|---|---|---|
| address | string | yes | Exact chain-native mint or contract address. |
| chain | string | yes | Token chain. |
| intended_size_usd | number | yes | Hypothetical notional used only for liquidity screening. |
| max_slippage_bps | integer | – | Hypothetical maximum slippage in basis points. Defaults to 100. |
No output schema declared.
No examples provided.
invalidate_safe_nonce ~496
Not available in this build: refuses before any request (it needs an independent chain proof that the no-op executed, which this client does not have). Release a stuck Safe nonce in the Felix app (Wallet) instead. Release this account's Arc home Safe nonce that an earlier Felix operation reserved but never executed (an expired, cancelled or observe-only HyperCore or Polymarket funding, or a same-chain Arc withdrawal). While such a nonce is reserved, every later Felix Safe move is refused. The owner signs ONE no-op Safe transaction (a call to the owner's own address, value 0, no data) at that nonce: it moves no funds, and once it executes the original can never execute. Before signing, the client rebuilds the no-op itself, checks it is for this account's Safe at the original's nonce, and proves the Safe's current nonce on its own private Arc quorum (FELIX_ARC_PROOF_RPC_URLS). Completion requires the engine's proof, this client's own proof that exactly this no-op executed, and Felix closing the original operation. If the original executed first, nothing is closed; resume the original instead. Use the exact original_writer and original_operation_id from the next_action of the tool that reported the reserved nonce. Felix keeps ONE invalidation per Safe nonce: when one already exists (next_action complete_invalidation), pass its invalidation_id to complete it instead of preparing a new one. Never use this tool while the blocking operation's next_action is reconcile_blocking_operation: its Safe transaction may still execute. Reuse the same idempotency_key after a timeout; nothing is signed twice.
| Name | Type | Req | Description |
|---|---|---|---|
| expected_safe_nonce | integer | – | Optional: the original's Safe nonce, when the reporting tool named it. The no-op must be at exactly this nonce. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it to resume this exact invalidation. |
| invalidation_id | string | – | Optional: an invalidation Felix already holds for this nonce (next_action complete_invalidation names it). It is completed instead of preparing a new one. |
| original_operation_id | string | yes | The original operation or funding id (UUID). |
| original_writer | string | yes | The Felix writer that reserved the nonce: withdrawal_source (a same-chain Arc withdrawal), hypercore (fund_hypercore_from_arc) or polygon (fund_polymarket_from_arc). |
No output schema declared.
No examples provided.
list_accounts ~91
List isolated child accounts owned by the launcher account. Archived accounts are hidden unless requested. When next_cursor is non-null, call again with that cursor until it is null; page order is opaque and is not creation order.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Optional account UUID cursor. |
| include_archived | boolean | – | Include safely archived child accounts. |
| limit | integer | – | Maximum accounts. Defaults to 50. |
No output schema declared.
No examples provided.
list_agents ~95
List this account's agents, including paused/error recovery instructions. Results are owner-scoped, bounded, and omit strategy source and encrypted state.
| Name | Type | Req | Description |
|---|---|---|---|
| before | string | – | Optional ISO-8601 created-at cursor returned as next_before. |
| limit | integer | – | Maximum agents, 1-100. Defaults to 20. |
| mode | string | – | Optional execution-mode filter. |
| status | string | – | Optional status filter. |
No output schema declared.
No examples provided.
list_exit_plans ~47
List this account's exit plans and trigger state.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | number | – | Maximum plans to return. Defaults to 100. |
| status | string | – | Optional plan status filter. |
No output schema declared.
No examples provided.
list_feedback ~31
List feedback reports belonging to this Felix account.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum reports, 1-50. |
No output schema declared.
No examples provided.
list_markets ~158
Page deterministically through a venue's complete market catalog, including active, future, resolved, or inactive markets. Follow next_cursor until complete is true.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Opaque next_cursor from the previous page. |
| kind | string | – | Optional venue product filter: Hyperliquid or Lighter perp|spot; Derive option|perp|erc20. |
| limit | integer | – | Page size, 1-200. Defaults to 100. |
| q | string | – | Optional text filter within the paginated catalog. |
| status | string | – | Lifecycle filter. Defaults to active. |
| venue | string | yes | Venue catalog. Use lighter:ETH for Lighter instruments; preview_order reports public API execution availability. |
No output schema declared.
No examples provided.
list_open_orders ~42
Live resting orders on Hyperliquid, Lighter and Polymarket (placed from the app or the API), with price, size, filled amount and status.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_recent_operations ~148
List durable local money operations for the active account, including progress, terminal results, and exact recovery instructions. Provide outbound_only (true or false) to read engine Arc Home operations instead; true filters that view to outbound operations. This is a pure read.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID for the Arc Home view. Requires outbound_only. |
| limit | integer | – | Maximum operations, 1-100 locally or 1-50 when outbound_only is provided. Defaults to 20. |
| outbound_only | boolean | – | Read engine Arc Home operations instead of the local journal. True includes only outbound operations; false includes all directions. Omit for the local journal. |
No output schema declared.
No examples provided.
list_support_tickets ~49
List encrypted support tickets for the active Felix account.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum tickets, 1-50. Defaults to 20. |
| status | string | – | Optional ticket status. |
No output schema declared.
No examples provided.
list_webhooks ~17
List active webhooks for this account.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
list_withdrawal_addresses ~57
List allowlisted withdrawal addresses and owner-authorization status. A launcher manage key may target one owned child with account_id.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Reload the launcher key before targeting a child. |
No output schema declared.
No examples provided.
make_market ~117
Reserved two-sided quote tool. Live use is disabled until compensated two-leg execution ships.
| Name | Type | Req | Description |
|---|---|---|---|
| ask_price | number | yes | Ask price. Must be above bid_price. |
| bid_price | number | yes | Bid price. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| instrument | string | yes | Instrument, e.g. BTC, NVDA, lighter:ETH, option:BTC-20260711-70000-C, pm:<slug>. |
| size | number | yes | Contract/share amount. |
No output schema declared.
No examples provided.
migrate_wallet_to_v3 ~242
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). Migrate a caller-owned legacy Safe to Felix V3 in one resumable local workflow: prove ownership, deploy only the V3 policy, locally execute enable/fallback/disable-V2, and confirm atomic account promotion.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| daily_limit_usd | number | – | Maximum autonomous daily total. Defaults to the legacy wallet limit. |
| delegation_days | integer | – | Owner-signed V3 agent delegation lifetime. Defaults to 30 days; maximum 90. |
| idempotency_key | string | yes | Required durable workflow key, 1-128 printable ASCII characters. |
| lifetime_limit_usd | number | – | Maximum cumulative autonomous total for this V3 module. |
| max_operation_usd | number | – | Maximum autonomous operation size. Defaults to the legacy wallet limit. |
| resume_reconciliation | boolean | – | Set true to resume the exact migration after checking an interrupted owner transaction. |
No output schema declared.
No examples provided.
modify_order_price ~73
Move a live resting limit order to a new limit price (same size and side).
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Retry-safety key. Auto-generated when omitted. |
| limit_price | number | yes | New positive limit price. |
| order_id | string | yes | Resting order id from list_open_orders. |
No output schema declared.
No examples provided.
onboard ~207
Set up Felix for this owner from inside the chat: asks the owner to accept the Felix Terms of Service, Privacy Policy and Risk Disclosure, then creates the owner key in macOS Keychain, registers the launcher, writes and verifies the encrypted recovery file, and loads the identity into this session (no restart). When the MCP client can show questions, Felix asks the owner directly. Otherwise the first call returns the exact question: ask the owner in chat, and only if they say yes call again with owner_accepted_terms:true and terms_version; macOS then shows one native confirmation the owner must click. Never answer for the owner. Local stdio only. No key or recovery code is returned.
| Name | Type | Req | Description |
|---|---|---|---|
| owner_accepted_terms | boolean | – | Only when the client cannot ask the owner directly: true after the owner answered yes, in this chat, to the exact question this tool returned. |
| terms_version | string | – | The terms version the owner accepted, exactly as returned by the first call. |
No output schema declared.
No examples provided.
onboard_hyperliquid ~57
Complete Hyperliquid approveAgent onboarding for a child account (needed after the account is funded before it can trade). The owner key signs the approval locally and never reaches Felix.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | yes | Child account UUID. |
No output schema declared.
No examples provided.
panic ~57
Emergency stop: block new exposure, cancel and flatten where possible, and revoke every active key for this account. Set confirm=true; there is no hidden phrase or waiting period.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm | boolean | yes | Set true to execute the emergency stop immediately. |
No output schema declared.
No examples provided.
place_batch_orders ~150
Place orders in one explicit mode. mode:live executes real-money orders; mode:paper simulates every item. Mixed or implicit modes are rejected. The schema accepts up to 50 items, but the active tier's order-per-minute allowance applies to the entire batch (10 on free). Processing stops before later live items after the first failure. Pass idempotency_key to make a retry safe.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| mode | string | yes | Required batch mode: live or paper. |
| orders | array | yes | Orders: {instrument, side, size_usd, type?, limit_price?, allow_leverage?}. |
No output schema declared.
No examples provided.
place_manual_order ~585
Place a LIVE manual order exactly like the app's ticket: market or limit, post-only, resting (Polymarket time_in_force GTC), reduce-only, leverage up to the venue maximum. This moves real money. Opening orders stay within this key's max_order_usd and max_daily_usd and the account's portfolio mandate. An account's own key does not fund from Home: fund the venue first with fund_hypercore_from_arc or fund_polymarket_from_arc. If the account owner's trading policy (the app's device trading policy) is missing or within 3 days of expiry, it is signed locally first and returned in trading_policy (it includes Lighter Premium and Felix partner-fee consent). Reuse the same idempotency_key to retry safely; read the outcome with get_manual_order_receipt.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_trading_policy | boolean | – | Only after the owner answered yes to the trading_policy question this tool returned. |
| expected_position_id | string | – | With reduce_only, the position this order reduces. |
| funding | object | – | Fund this order's venue from the account's Home: {max_source_units, max_fee_units, expires_at}, integers (USDC 6-decimal units; expires_at in Unix seconds). Needs a key with the 'transfer' scope (the… |
| idempotency_key | string | – | Retry-safety key; reuse it for retries of the same order. Auto-generated when omitted. |
| instrument | string | yes | perp:<COIN> (Hyperliquid), lighter:<SYMBOL> (Lighter) or pm:<slug> (Polymarket). |
| leverage | integer | – | Leverage for perps, 1 up to the venue maximum for the market. |
| limit_price | number | – | Limit price (required for type limit). |
| outcome | string | – | Polymarket outcome name (e.g. Yes, No, a team, Draw). |
| post_only | boolean | – | Limit orders only: rest on the book, never take (Hyperliquid, Lighter; Polymarket with time_in_force GTC). |
| reduce_only | boolean | – | Only reduce an existing position. |
| side | string | yes | buy or sell (perps: buy = long, sell = short). |
| size_usd | number | yes | USD notional of the order. |
| time_in_force | string | – | Polymarket only: FAK (default, fill what is there now) or GTC (rest on the book; limit only). |
| trading_policy_terms_id | string | – | The trading_policy_terms_id from that question. |
| type | string | – | market (default) or limit. |
No output schema declared.
No examples provided.
place_order ~649
Place a real-money order by default, optionally funding the selected venue first and attaching a server-monitored OCO exit plan. Set auto_fund:true for one-call local-signing fund-then-trade; it requires an idempotency_key and never exposes the owner key. Set paper:true explicitly to simulate. Leveraged Hyperliquid exposure is blocked unless allow_leverage:true is explicit. Pass idempotency_key to make a retry safe.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_leverage | boolean | – | Set true only after reviewing collateral. Omitted or false blocks orders whose notional exceeds free Hyperliquid collateral. |
| auto_fund | boolean | – | When true, preflight and locally sign the minimum owner-to-venue funding needed before placing the live order. |
| auto_swap_native_usdc | boolean | – | Allow the auto-funding workflow to convert only the needed Polygon native USDC to USDC.e. Defaults to true. |
| break_even_after_pct | number | – | After this profit fraction, close if price returns to entry. |
| idempotency_key | string | – | Optional retry-safety key; required when attaching an exit plan. |
| instrument | string | yes | Instrument, e.g. BTC, NVDA, lighter:ETH, option:BTC-20260711-70000-C, pm:<slug>. |
| limit_price | number | – | Optional paper limit price. For live Polymarket market/FOK orders, this is an explicit maximum buy price or minimum sell price that Felix must match exactly; type:"limit" remains paper-only. |
| max_auto_fund_usd | number | – | Optional hard ceiling on venue funding. When omitted, auto_fund may move only the minimum amount disclosed by preview_order.auto_fund_plan; the separately disclosed network fee still applies. |
| max_holding_minutes | number | – | Close after this many minutes regardless of PnL. |
| max_round_trip_loss_pct | number | – | Maximum projected immediate round-trip loss for live Derive orders. Defaults to the server safety threshold. |
| paper | boolean | – | Set true explicitly for a paper simulation. Omitted or false means real-money execution and requires a live-enabled key. |
| reduce_only | boolean | – | Only reduce an existing live position when supported. |
| resume_reconciliation | boolean | – | Resume this exact auto-funded order only after confirming its saved workflow state and current balances. Never use a new idempotency key. |
| side | string | yes | buy|sell|long|short|yes|no |
| size_usd | number | yes | Dollar notional to spend or trade. |
| stop_loss_pct | number | – | Close when loss from entry reaches this decimal fraction, e.g. 0.05 for 5%. |
| take_profit_pct | number | – | Close when profit from entry reaches this decimal fraction, e.g. 0.10 for 10%. |
| trailing_activation_pct | number | – | Optional profit fraction required before the trailing stop arms. Defaults to immediate. |
| trailing_stop_pct | number | – | Ratchet behind the favorable price by this decimal fraction. |
| type | string | – | market|limit. Live supports market only; limit is paper-simulation only. |
No output schema declared.
No examples provided.
portfolio_backtest ~341
Replay two to six caller-owned saved agents as fixed independent capital sleeves. Returns full-period and chronological cold-state holdout equity, attribution, fees, slippage, correlation, covariance, and explicit pass/fail criteria. It does not model shared margin, cross-venue netting, capital reuse, or market impact; the holdout is independently out-of-sample only when the strategies were frozen before inspection. This computation never signs, funds, deploys, changes agents, moves money, or submits orders.
| Name | Type | Req | Description |
|---|---|---|---|
| bars | integer | – | Exact aligned historical bars. Defaults to 600. |
| capital | number | – | Total hypothetical capital. Every sleeve must receive at least $10. |
| fee_bps_per_side | number | – | Execution fee applied to every simulated fill. Defaults to 5 bps. |
| holdout_fraction | number | – | Chronological cold-state holdout fraction. Defaults to 0.30. |
| idempotency_key | string | yes | Required stable retry key. Reuse it after any timeout. |
| interval | string | – | Shared bar interval. Defaults to 1h. |
| max_holdout_drawdown_pct | number | – | Optional maximum absolute combined holdout drawdown percentage. |
| min_holdout_return_pct | number | – | Optional minimum combined holdout return percentage. |
| min_holdout_trades | integer | – | Minimum combined holdout trades. Defaults to 1. |
| sleeves | array | yes | Two to six unique saved agents. Weights must total exactly 10000 bps. |
| slippage_bps_per_side | number | – | Adverse movement applied to every simulated fill. Defaults to 0 bps. |
No output schema declared.
No examples provided.
prepare_arc_transfer ~284
Prepare an owner-signed Circle Gateway USDC transfer between Gateway domains (for example Arc and Base, Polygon, Ethereum, or Arbitrum) through Felix Arc settlement. Returns the settlement operation id, the exact approve, deposit, and burn-intent payloads the owner must sign, the deposit total including the fee ceiling, and the expiry heights. Nothing is signed or broadcast and no money moves; call submit_arc_transfer with the same arguments and idempotency_key to execute.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | USDC that must arrive on the destination, in whole USDC (six decimals). |
| destination_domain | integer | yes | Circle Gateway domain id of the destination chain; must differ from source_domain. |
| idempotency_key | string | yes | Journey replay key. Reuse it for submit_arc_transfer so the same prepared journey is executed, and after any timeout. |
| maximum_fee_usd | number | – | Maximum Circle Gateway fee the owner accepts on top of amount_usd. Defaults to 0.05 USDC; the deposit is amount plus this ceiling and any unused ceiling stays in the owner's Gateway balance. |
| source_domain | integer | yes | Circle Gateway domain id of the source chain (Ethereum 0, Arbitrum 3, Base 6, Polygon 7; Arc's id is reported by get_deposit_address under arc.gateway_domain). |
No output schema declared.
No examples provided.
prepare_capital_allocation ~143
Prepare an owner-signed Home-to-own-trading-pool allocation. Does not sign or submit. Review the returned Safe transaction locally before submit_capital_allocation. This is not an external withdrawal.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount | string | yes | Exact USDC decimal amount, minimum 1 USDC, at most six decimal places. |
| confirm | boolean | yes | Must be true after the owner reviews this exact action. |
| deployment_id | string | – | Optional owned pending deployment UUID. |
| idempotency_key | string | yes | Required durable retry key. Preserve it and the exact request after an uncertain result. |
No output schema declared.
No examples provided.
prepare_derive_onboarding ~114
Prepare exact Derive-chain transactions for the verified owner wallet to send. Felix never receives the owner key.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| expiry_days | number | – | Session lifetime in days, 1-30. Defaults to 30. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| max_deposit_usd | number | yes | Exact maximum Derive USDC allowance, up to the $1B protocol range. |
No output schema declared.
No examples provided.
prepare_polymarket_withdrawal_grant ~100
Build the exact fixed-home Polymarket withdrawal message for the client-owned wallet to sign. This never signs or moves funds.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| expires_in_seconds | integer | – | Grant lifetime from 120 to 86400 seconds. |
| max_operation_usd | number | – | Optional owner-authorized pUSD moved home per operation. Defaults to the $1B protocol range. |
No output schema declared.
No examples provided.
prepare_venue_bootstrap ~67
Prepare optional owner consent for first venue-account seeds. No signature or transfer. Review every seed and the total debit; bootstrap can use 24 USDC including gas and is not required to trade all venues at once.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
No output schema declared.
No examples provided.
prepare_wallet_policy ~155
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). Prepare an owner-signed Safe V3 pause, resume, renewal, or emergency lockdown. Lockdown atomically pauses the agent and revokes fixed Polymarket approvals.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| action | string | yes | pause|resume|renew|lockdown. |
| delegation_days | integer | – | Renewal lifetime in days. Valid only for renew; maximum 90. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
No output schema declared.
No examples provided.
prepare_withdrawal ~191
Prepare an exact Safe withdrawal transaction after allowlist checks. USDC.e means bridged USDC.e on Polygon, which many centralized exchanges do not support; prefer a self-custody Polygon wallet and convert before an exchange deposit. Returns EIP-712 data for the owner to sign locally; no money moves yet.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount | number | yes | Amount in token units. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| to | string | yes | Confirmed allowlisted Polygon destination. |
| token | string | – | USDC.e|USDC|pUSD. Defaults to USDC.e. |
| withdrawal_confirmation | object | – | 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.
preview_capital_move ~162
Inspect balances and availability before an allocated-capital move. Funding draws from the account's already allocated trading pool; returns go to its Arc Home. Includes Derive and treasury previews, but those moves require owner approval and are not available via API key. This is a read-only availability plan, not a provider cost quote: unknown fees and credit remain unknown. Review the returned transfer availability before separately confirming a supported start_capital_move.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | Exact requested amount, with at most six decimal places. |
| direction | string | yes | fund uses allocated capital; bring_home returns to Arc Home. |
| venue | string | yes | Venue. treasury is allowed only for bring_home. |
No output schema declared.
No examples provided.
preview_covariance_risk_trim ~184
Preview one covariance-aware reduction of an existing verified linear exposure toward the owner volatility mandate. An optional target may tighten but never loosen that mandate. The result is bound to an exact Hyperliquid preview and never signs, funds, bridges, submits, changes a position, or moves money.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| asset | string | yes | Canonical asset with an existing verified linear USD delta to reduce. |
| max_size_usd | number | yes | Maximum current-position notional the preview may reduce. |
| observations | array | yes | The same aligned daily returns used for historical risk, covering every verified linear delta asset. |
| target_portfolio_volatility_pct | number | – | Optional annualized volatility target from 0 to 100 percent. It may tighten but never loosen the owner mandate. |
No output schema declared.
No examples provided.
preview_derive_greek_hedge ~212
Rank up to four exact Derive buy-to-open option previews that reduce one verified net gamma, theta, or vega exposure. Uses the matching owner net-Greek limit unless target_abs_net is explicit. Gross risk and multiple Greeks are not collapsed into a fake optimum. Never signs, funds, bridges, or trades; refresh preview_order before any separate order.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| asset | string | yes | Canonical Derive underlying returned by get_portfolio_risk. |
| max_candidates | integer | – | Maximum exact quote previews after bounded chain preselection. Defaults to 4. |
| max_size_usd | number | yes | Maximum premium and immediate venue cost budget for each exact candidate preview. |
| metric | string | yes | Net higher-order sensitivity to reduce. |
| target_abs_net | number | – | Optional absolute-net target in Derive venue-native position-Greek units. Omit to use the owner mandate. |
No output schema declared.
No examples provided.
preview_execution_route ~179
Select the lowest-cost fully verified immediate route for one explicit economic objective. Compares only semantically compatible products, keeps unknown costs unknown, and never signs, funds, bridges, or submits an order.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| allow_leverage | boolean | – | Set true only after reviewing collateral. Omitted or false blocks orders whose notional exceeds free Hyperliquid collateral. |
| instrument | string | yes | Instrument, e.g. BTC, NVDA, lighter:ETH, option:BTC-20260711-70000-C, pm:<slug>. |
| objective | string | yes | Economic objective. |
| side | string | yes | buy|sell|long|short|yes|no |
| size_usd | number | yes | Dollar notional to spend or trade. |
No output schema declared.
No examples provided.
preview_fee_settlement ~85
Legacy, not needed to trade. Deprecated compatibility alias for preview_fee_top_up. It previews prepaid execution-fee credit and never exposes the collection address.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | USDC.e amount to prepay for future live execution fees. |
| idempotency_key | string | yes | Required workflow replay key. Reuse this exact key for settle_fees. |
No output schema declared.
No examples provided.
preview_fee_top_up ~103
Legacy, not needed to trade (Felix's fee is charged after each fill). Preview an owner-signed execution-fee credit top-up without signing or exposing Felix's collection address. Nothing moves until top_up_fee_balance is called.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | USDC.e amount to prepay for future live execution fees. |
| idempotency_key | string | yes | Required workflow replay key. Reuse this exact key for top_up_fee_balance. |
No output schema declared.
No examples provided.
preview_fleet_capacity ~97
Preview account-wide unlevered fleet capacity from verified cash, gross headroom, and active agent budgets. Optional weights must cover owned active agents and total 10000 basis points. Never reserves capital, updates agents, funds, or trades.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| agent_weights | array | – | Optional exact active-agent allocation totaling 10000 basis points. |
No output schema declared.
No examples provided.
preview_fleet_reallocation ~124
Plan an explicit owner-selected live-capital target across every active agent. Reductions come before dependent-limit reviews and budget changes. Historical performance never chooses weights. Never changes an agent, position, order, funding route, or balance.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| agent_weights | array | yes | Exact owner-selected split across every active owned agent, totaling 10000 basis points. |
| target_deployed_capital_usd | number | yes | Explicit total live-capital target across the active fleet. |
No output schema declared.
No examples provided.
preview_funding_route ~171
Read-only preview of owner-wallet funding to Hyperliquid (crypto) or Derive (options). A quote, including executable:true, does not certify a route for this release: Derive/options funding is under release hold and must not be started. Hyperliquid quotes include provider, expected credit, all-in cost, and estimated duration. This bounded read never creates an operation, intent, fee obligation, or reservation, requests a signature, submits an order, or moves money.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| amount_usd | number | yes | Owner-wallet funding amount to quote, from $5 through $200. |
| venue | string | yes | Destination venue. crypto and hyperliquid are equivalent; options and derive are equivalent. |
No output schema declared.
No examples provided.
preview_historical_portfolio_risk ~108
Calculate historical-simulation VaR and expected shortfall for the verified current linear book using 20-500 caller-supplied daily return rows. Refuses nonlinear or incomplete books and never moves money.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| confidence_pct | integer | yes | Historical tail confidence: 95 or 99. |
| observations | array | yes | Daily close-to-close returns for every verified linear delta asset. |
No output schema declared.
No examples provided.
preview_home_funding ~109
Quote Home funding for Hyperliquid, Lighter or Polymarket through an owner-signed capital allocation. No operation is created. Preserve costs, expiry, quote_token and quote_execution_bound:false: the worker obtains a fresh quote, so this is not a signed all-in ceiling.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | Gross debit including owner-paid Arc gas, at most six decimals. |
| venue | string | yes | Venue. |
No output schema declared.
No examples provided.
preview_manual_order ~378
Quote a manual order without placing it: size, margin, fees, estimated fill and liquidation price. Nothing is reserved, funded, signed or sent.
| Name | Type | Req | Description |
|---|---|---|---|
| expected_position_id | string | – | With reduce_only, the position this order reduces. |
| funding | object | – | Fund this order's venue from the account's Home: {max_source_units, max_fee_units, expires_at}, integers (USDC 6-decimal units; expires_at in Unix seconds). Needs a key with the 'transfer' scope (the… |
| instrument | string | yes | perp:<COIN> (Hyperliquid), lighter:<SYMBOL> (Lighter) or pm:<slug> (Polymarket). |
| leverage | integer | – | Leverage for perps, 1 up to the venue maximum for the market. |
| limit_price | number | – | Limit price (required for type limit). |
| outcome | string | – | Polymarket outcome name (e.g. Yes, No, a team, Draw). |
| post_only | boolean | – | Limit orders only: rest on the book, never take (Hyperliquid, Lighter; Polymarket with time_in_force GTC). |
| reduce_only | boolean | – | Only reduce an existing position. |
| side | string | yes | buy or sell (perps: buy = long, sell = short). |
| size_usd | number | yes | USD notional of the order. |
| time_in_force | string | – | Polymarket only: FAK (default, fill what is there now) or GTC (rest on the book; limit only). |
| type | string | – | market (default) or limit. |
No output schema declared.
No examples provided.
preview_order ~368
Preview an order before placing it. No money moves; returns estimated fill, fees, live minimum, collateral, selected venue, and projected Hyperliquid leverage. fee_credit_check reports how the Felix fee is collected: it is charged from the trading account after each fill and never blocks an order, so no prepaid fee credit or top-up is needed. Derive options also return exact quote-sized signed delta plus venue-native gamma, theta, and vega impact; missing Greeks remain unavailable, never zero. Set auto_fund:true to include the exact owner-to-venue funding plan without executing it.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_leverage | boolean | – | Set true only after reviewing collateral. Omitted or false blocks orders whose notional exceeds free Hyperliquid collateral. |
| auto_fund | boolean | – | Include a read-only funding plan when venue collateral is short. This preview never moves money. |
| instrument | string | yes | Instrument, e.g. BTC, NVDA, lighter:ETH, option:BTC-20260711-70000-C, pm:<slug>. |
| limit_price | number | – | Optional paper limit price. For live Polymarket market/FOK orders, this is an explicit maximum buy price or minimum sell price that Felix must match exactly; type:"limit" remains paper-only. |
| max_round_trip_loss_pct | number | – | Maximum projected immediate round-trip loss for live Derive orders. Defaults to the server safety threshold. |
| reduce_only | boolean | – | Only reduce an existing live position when supported. |
| side | string | yes | buy|sell|long|short|yes|no |
| size_usd | number | yes | Dollar notional to spend or trade. |
| type | string | – | market|limit. Live supports market only; limit is paper-simulation only. |
No output schema declared.
No examples provided.
preview_portfolio_hedge ~111
Preview a combined-book Hyperliquid hedge for one verified linear asset delta. Includes current portfolio limits and venue executability checks, never infers nonlinear hedges, and never signs, funds, bridges, or trades.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| allow_leverage | boolean | – | Permit a leveraged hedge candidate only after explicit review. |
| asset | string | yes | Canonical asset symbol returned by get_portfolio_risk. |
No output schema declared.
No examples provided.
preview_portfolio_order ~185
Preview an order against combined portfolio position, gross, concentration, daily-loss, reserve, and leverage limits. No order is placed; call preview_order separately for venue fees, minimums, collateral, liquidity, and slippage.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| allow_leverage | boolean | – | Set true only after reviewing collateral. Omitted or false blocks orders whose notional exceeds free Hyperliquid collateral. |
| instrument | string | yes | Instrument, e.g. BTC, NVDA, lighter:ETH, option:BTC-20260711-70000-C, pm:<slug>. |
| side | string | yes | buy|sell|long|short|yes|no |
| size_usd | number | yes | Dollar notional to spend or trade. |
| venue | string | yes | Execution venue. |
No output schema declared.
No examples provided.
preview_portfolio_stress ~81
Run one to eight deterministic first-order stress scenarios against verified portfolio delta. Nonlinear positions require explicit P&L adjustments; incomplete risk remains unavailable. Never signs, funds, bridges, or trades.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| scenarios | array | yes | Bounded deterministic scenarios. |
No output schema declared.
No examples provided.
preview_rebalance ~94
Preview committed-capital allocation targets under the applied mandate. Deltas are not order notionals or transfer amounts; cash is a reserve, not a destination venue. Select positions/instruments and preview orders plus portfolio risk first. Only a verified venue cash shortfall justifies funding. Never signs, funds, bridges, or trades.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
No output schema declared.
No examples provided.
preview_return_route ~153
Read-only quote of the Hyperliquid-to-Polygon Relay return route, including collateral headroom, expected owner-wallet credit, all-in cost, and estimated duration. This legacy owner-wallet quote is separate from allocated-capital Relay returns to Arc Home; use preview_capital_move and start_capital_move for those. This bounded read never creates an operation, requests a signature, submits an order, or moves money.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| amount_usd | number | yes | Hyperliquid USDC amount to quote, from $1 through $200. |
| venue | string | yes | Source venue. crypto and hyperliquid are equivalent. |
No output schema declared.
No examples provided.
reconcile_arc_home_operation ~79
Advance one Arc home operation from chain and Circle evidence. Signs nothing and moves no new owner funds; Felix may relay an already owner-signed Arc Safe transaction. Use it to recover any operation whose next_action is reconcile.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| operation_id | string | yes | Arc home operation UUID. |
No output schema declared.
No examples provided.
reconcile_polymarket_order ~102
Resume the side-effect-free Felix commit/reconciliation step when Polymarket returned an order hash but the API response was interrupted. This never posts a venue order.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| intent_id | string | yes | Polymarket live-order intent UUID. |
| order_id | string | yes | Exact 0x-prefixed Polymarket order hash returned by the local signer. |
No output schema declared.
No examples provided.
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
claude mcp add trade-felix-mcp -- npx -y felix-mcp
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.