Felix MCP
NPM · FELIX-MCP
Non-custodial trading infrastructure for AI agents across prediction markets, crypto, and options.
Available components
Last scanned (22 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 →
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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Reload the launcher key before targeting a child. |
| address | string | yes | 0x Polygon address to allowlist. |
| chain | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_id | string | yes | Agent 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| agent_weights | array | yes | Exact reviewed split across every active owned agent, totaling 10000 basis points. |
| expected_policy_version | integer | yes | Portfolio mandate version returned by the reviewed preview. |
| idempotency_key | string | yes | Stable retry-safety key for this exact fleet update. |
| target_deployed_capital_usd | number | yes | Exact 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dry_run | boolean | – | Read approval state without signing or submitting a relayer operation. |
| idempotency_key | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | USDC to credit into the Arc home Safe, at most six decimals. |
| idempotency_key | string | yes | Required durable workflow key. Reuse it after any timeout or restart. |
| max_fee_usd | number | – | Owner-paid Circle Gateway fee ceiling. Defaults to 0.05. |
| resume_reconciliation | boolean | – | Set true only to resume this exact interrupted deposit after reading its operation. |
| source_chain | string | yes | Source 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | USDC to deliver to the Polygon owner wallet, at most six decimals. |
| idempotency_key | string | yes | Required durable workflow key. Reuse it after any timeout or restart. |
| max_fee_usd | number | – | Owner-paid Circle Gateway fee ceiling. Defaults to 0.05. |
| resume_reconciliation | boolean | – | Set true only to resume this exact interrupted funding operation. |
| submit_destination_mint | boolean | – | 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. |
| venue | string | yes | Destination 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.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | Exact USDC to send from HyperCore perps, 5 to 25, at most six decimals. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it to resume this exact return. |
| minimum_credit_usd | number | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | USDC to deliver to the destination, at most six decimals. |
| chain | string | yes | Destination chain. |
| idempotency_key | string | yes | Required durable workflow key. Reuse it after any timeout or restart. |
| max_fee_usd | number | – | Owner-paid Circle Gateway fee ceiling for a cross-chain withdrawal. Defaults to 0.05; must be 0 for chain=arc. |
| resume_reconciliation | boolean | – | Set true only to resume this exact interrupted withdrawal after reading its operation. |
| submit_destination_mint | boolean | – | 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. |
| to | string | yes | Exact destination: the owner address, or an address allowlisted for that chain. |
| 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.
archive_account ~73
Owner-pause and archive a flat child account, revoke every child key, and retain wallet and financial records for audit.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | yes | Owned child account UUID. |
| confirm_account_id | string | yes | Must exactly repeat account_id. |
| idempotency_key | string | yes | Required 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.
| Name | Type | Req | Description |
|---|---|---|---|
| bars | integer | – | Historical bars; interval-specific limits apply and are validated locally. |
| capital | number | – | Starting capital. |
| detail | string | – | summary (default) or full raw result. |
| idempotency_key | string | – | Optional retry-safety key. Reuse the exact key after an interrupted synchronous request. |
| interval | string | – | 1m|5m|15m|1h|4h|1d |
| markets | array | – | Optional instruments/markets, max 4. |
| name | string | – | Display name, max 80 characters. |
| strategy_id | string | yes | Owned strategy UUID returned by generate_strategy. |
| years | number | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | yes | Required stable retry key. Reuse it after any timeout. |
| interval | string | – | Bar interval. Defaults to 1h. |
| market | string | yes | One canonical instrument shared by every scenario. |
| min_trades | integer | – | 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… |
| scenarios | array | yes | Two to eight bounded scenarios on the same immutable dataset end. |
| strategy_id | string | yes | Owned strategy UUID returned by generate_strategy. |
| venue | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_high_fee_loss | boolean | – | Crypto only: accept a high proportional route cost if the selected provider requires it. Never enabled by default. |
| amount_usd | number | – | Amount to return. Omit to sweep the full spendable prediction-market balance. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it after any timeout or restart. |
| resume_reconciliation | boolean | – | 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. |
| venue | string | yes | Source 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| instrument_volatility_pct | number | – | Annualized instrument volatility; required for volatility_target. |
| invalidation_distance_pct | number | yes | Adverse move at which the thesis is invalidated. |
| method | string | yes | Sizing 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| request_id | string | yes | request_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.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | yes | Required retry-safety key. |
| position_id | string | yes | Owned 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.
| Name | Type | Req | Description |
|---|---|---|---|
| order_id | string | yes | Resting 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.
| Name | Type | Req | Description |
|---|---|---|---|
| order_id | string | yes | Resting 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.
| Name | Type | Req | Description |
|---|---|---|---|
| position_id | string | yes | Position id. |
| version | integer | yes | Current 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| capital_operation_id | string | yes | Original capital operation UUID. |
| idempotency_key | string | yes | Required cancellation workflow key. Reuse the exact key after interruption. |
| transaction_hash | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Retry-safety key; reuse it to read the receipt. Auto-generated when omitted. |
| percent | number | – | Close this percent of the position, 1-100 (omit for a full close). |
| position_id | string | yes | Position id from get_positions. |
| size_usd | number | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| position_id | string | yes | UUID 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.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| ticket_id | string | yes | Support 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional caller-owned Felix subaccount UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| onboarding_id | string | yes | Hyperliquid onboarding UUID. |
| signature | string | yes | 65-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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| enable_signature | string | yes | 0x-prefixed 65-byte canonical Safe signature. |
| fallback_signature | string | yes | 0x-prefixed 65-byte canonical signature for the returned fallback_safetx. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| onboarding_id | string | yes | Onboarding 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Reload the launcher key before targeting a child. |
| addr_id | string | yes | Withdrawal 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.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_terms | boolean | yes | Must be true to confirm acceptance of Felix Terms of Service, Privacy Policy, and Risk Disclosure. |
| accept_trading_policy | boolean | – | Only after the owner answered yes to the trading_policy_question this tool returned. |
| delegation_days | integer | – | Delegation duration in days. Defaults to 30; maximum 90. |
| string | – | Optional new email for the isolated child. Omit to generate an internal identity. | |
| idempotency_key | string | yes | Stable account-creation key. Reuse the exact value after any interruption. |
| label | string | – | Optional account/live-key label. |
| legal_version | string | – | Current Felix legal bundle version. Omit to use the version bundled with this MCP build. |
| lifetime_limit_usd | number | – | Optional Safe delegation lifetime safety ceiling. Defaults/maxes at $1B. |
| max_daily_loss_usd | number | – | Optional owner-authorized daily loss safety ceiling. Defaults/maxes at $100M. |
| max_daily_usd | number | – | Optional owner-authorized daily notional safety ceiling. Defaults/maxes at the account's $100M daily limit. |
| max_order_usd | number | – | Optional owner-authorized per-order safety ceiling. Defaults/maxes at the account's $10M operation limit. |
| resume_reconciliation | boolean | – | Set true only to resume this exact workflow after inspecting an interrupted attempt. |
| trading_policy_terms_id | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| from_amount | number | yes | Amount of from_currency you will send. |
| from_currency | string | yes | Deposit token key from get_deposit_address list_currencies, for example usdc_base. |
| idempotency_key | string | yes | Required. 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.
| Name | Type | Req | Description |
|---|---|---|---|
| label | string | – | Optional label/source, up to 60 characters. |
| rev_share_bps | integer | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | – | Problem area. Defaults to support. |
| context | object | – | Optional diagnostic identifiers only; never include secrets. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| message | string | yes | Problem description, 10-4000 characters. |
| severity | string | – | Severity. Defaults to medium. |
| subject | string | yes | Short 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.
| Name | Type | Req | Description |
|---|---|---|---|
| events | array | – | 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_key | string | – | Optional stable retry key. Reuse it after an interrupted registration. |
| url | string | yes | Public HTTPS URL. No localhost/private IPs. |
No output schema declared.
No examples provided.
delete_webhook ~26
Delete a webhook by id.
| Name | Type | Req | Description |
|---|---|---|---|
| webhook_id | string | yes | Webhook 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.
| Name | Type | Req | Description |
|---|---|---|---|
| acknowledge_unvalidated | boolean | – | Explicitly acknowledge missing or degraded replay evidence when deploying live. |
| allow_leverage | boolean | – | Explicitly permit a live Hyperliquid perp agent to exceed free collateral. Omitted or false blocks leveraged exposure before signing. |
| break_even_after_pct | number | – | Optional profit fraction that activates a break-even exit. |
| budget_usd | number | yes | Explicit agent capital budget. |
| confirmed_budget_usd | number | – | 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_seconds | number | – | Loop interval. Polymarket supports 5-86400 seconds; other venues support 30-86400 seconds. |
| idempotency_key | string | – | Optional retry-safety key. Reuse it to recover an interrupted deployment without creating a second agent. |
| markets | array | yes | One to four owner-authorized instruments. Every live open outside this list fails before signing. |
| max_daily_loss_usd | number|null | – | Explicit daily-loss ceiling. Omit or use null for no selected agent limit; live key caps still apply. |
| max_holding_minutes | number | – | Optional maximum position age in minutes. |
| max_position_usd | number|null | – | Explicit position ceiling. Omit or use null for no selected agent limit; live key caps still apply. |
| mode | string | – | paper|live. Defaults to live; set paper explicitly to simulate. |
| name | string | – | Agent name. |
| prompt | string | – | Optional source prompt for audit/history. |
| replay_attestation | string | – | Replay attestation token returned by backtest for this exact strategy. |
| stop_loss_pct | number | – | 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_id | string | yes | Owned strategy UUID returned by generate_strategy. |
| take_profit_pct | number | – | Optional server-monitored profit target fraction. |
| trailing_activation_pct | number | – | Optional profit fraction before the trailing stop arms. |
| trailing_stop_pct | number | – | Optional server-monitored trailing distance fraction. |
| venue | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| dry_run | boolean | – | Read deployment state without deploying or spending gas. |
| idempotency_key | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| onboarding_id | string | yes | Onboarding UUID. |
| proof_signature | string | yes | 0x-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.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_terms | boolean | yes | Must be true to confirm acceptance of Felix Terms of Service, Privacy Policy, and Risk Disclosure. |
| activate | boolean | – | Switch this local MCP session to the derived key without exposing it. Raw key export is disabled. |
| string | – | Optional new email for the isolated child. Omit to generate a fresh internal child identity. | |
| idempotency_key | string | – | Optional stable retry key for this account creation. Reuse it after a timeout. |
| label | string | – | Optional label, max 80 chars. Defaults server-side. |
| legal_version | string | – | Current Felix legal bundle version. Omit to use the version bundled with this MCP build. |
| paper | boolean | yes | Required 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.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_activation_cost_usd | number | – | 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_usd | number | yes | Exact transfer principal, 5 to 25 USDC, at most six decimals. Excludes the additional 1.00 USDC Felix fee. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it to resume this exact funding. |
| minimum_credit_usd | number | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | 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_usd | number | yes | Amount to fund. |
| auto_swap_native_usdc | boolean | – | Automatically convert only the native Polygon USDC needed for this funding operation. Defaults to true; set false to require a separate explicit swap. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it after any timeout or restart. |
| minimum_receive_usd | number | – | Optional minimum final venue credit. The route fails closed before submission when its bounded quote cannot satisfy this floor. |
| resume_reconciliation | boolean | – | 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. |
| venue | string | yes | Target 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | Exact pUSD amount to transfer from the client-owned Polymarket wallet to the autonomous agent wallet. |
| idempotency_key | string | yes | Required 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.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | Exact transfer principal, 5 to 25 USDC, at most six decimals. Excludes the additional 1.00 USDC Felix fee. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it to resume this exact funding. |
| minimum_credit_usd | number | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional stable retry key. Auto-generated when omitted; reuse after a timeout. |
| prompt | string | yes | Strategy 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.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | string | – | Opaque next_cursor from the previous page. |
| limit | integer | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_id | string | yes | Agent UUID. |
| before | string | – | Optional ISO-8601 cursor returned as next_before. |
| limit | integer | – | 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.
| 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.
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.
| Name | Type | Req | Description |
|---|---|---|---|
| operation_id | string | yes | Settlement operation id (UUID) from prepare_arc_transfer or the operation field of a submit_arc_transfer result. |
| reconcile | boolean | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| instrument | string | yes | perp: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.
| Name | Type | Req | Description |
|---|---|---|---|
| operation_id | string | yes | Operation 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.
| Name | Type | Req | Description |
|---|---|---|---|
| wait_for_complete | boolean | – | 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| move_id | string | yes | Engine 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.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| move_id | string | yes | Existing move UUID. |
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.