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 →
reload_launcher_key ~42
Reload the current launcher API key and owner signer from macOS Keychain, validate their encrypted workflow journal, and explicitly leave any child account. No secret is returned.
Input schema present but exposes no named parameters.
No output schema declared.
No examples provided.
repair_derive_session ~113
Renew an expired or missing Derive session in one local, owner-signed workflow while preserving the existing subaccount and funds.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| expiry_days | number | – | Renewed session lifetime in days. Defaults to 30. |
| idempotency_key | string | yes | Required stable workflow key. Reuse it after interruption. |
| max_deposit_usd | number | – | Owner-authorized Derive allowance; defaults to the $1B protocol range. |
No output schema declared.
No examples provided.
reply_support_ticket ~68
Add an encrypted message to an open caller-owned support ticket.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| message | string | yes | Reply text, 1-4000 characters. |
| ticket_id | string | yes | Support ticket UUID. |
No output schema declared.
No examples provided.
report_arc_home_mint ~95
Report the destination-chain gatewayMint transaction hash for a cross-chain Arc home withdrawal or venue staging that the recipient broadcast themselves. Felix verifies the receipt mints exactly the operation amount to the recipient before accepting it. Signs nothing.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| mint_tx_hash | string | yes | Destination-chain gatewayMint transaction hash. |
| operation_id | string | yes | Arc home operation UUID. |
No output schema declared.
No examples provided.
report_feedback ~100
Report a Felix bug, product issue, or request. Content is encrypted at rest and never logged.
| Name | Type | Req | Description |
|---|---|---|---|
| category | string | yes | Problem area. |
| 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. |
No output schema declared.
No examples provided.
request_withdrawal_confirmation ~85
Send an email code for one exact withdrawal intent. Does not authorize or move funds. Enter the code only through the trusted local MCP client; never put codes or proofs in shared transcripts.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| confirm | boolean | yes | Must be true after the owner reviews this exact action. |
| intent | object | yes | – |
No output schema declared.
No examples provided.
research_market ~88
Real historical research cards and agent-ready market signals without using the strategy-generation token budget.
| Name | Type | Req | Description |
|---|---|---|---|
| bars | integer | – | Historical bars. Free supports 750; paid tiers expose their larger limit in get_subscription. |
| interval | string | – | Research timeframe. Defaults to 1h. |
| symbol | string | yes | Ticker such as BTC, ETH, AAPL, SPY, or NVDA. |
No output schema declared.
No examples provided.
resolve_network_fee ~191
Recover one exact legacy or interrupted funding-fee obligation. Normal fund_market calls pay and confirm the fee before any venue transfer. action=release is allowed only when Felix proves no owner funds moved; action=pay is restricted to a previously verified owner-value transfer and cannot start new funding.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| action | string | – | Resolution action. Defaults to release for backward compatibility. |
| confirm_no_owner_funds_moved | boolean | – | Must be true for action=release after inspecting get_network_fee_status. |
| fee_obligation_id | string | yes | Obligation UUID returned by get_network_fee_status. |
| idempotency_key | string | yes | Required retry-safety key. Reuse it after any timeout. |
| max_payment_usd | number | – | Required caller-approved ceiling for action=pay. The exact fixed gas-wallet fee must not exceed it. |
No output schema declared.
No examples provided.
resume_backtest_operation ~50
Resume a durable backtest only after its operation lease expired, typically after an API restart. The encrypted original request is reused.
| Name | Type | Req | Description |
|---|---|---|---|
| operation_id | string | yes | Operation id returned by start_backtest. |
No output schema declared.
No examples provided.
resume_money_operation ~98
Resume an interrupted asynchronous money operation with its original encrypted arguments and idempotency key. When a prior send may have happened, confirm_reconciled:true is required.
| Name | Type | Req | Description |
|---|---|---|---|
| confirm_reconciled | boolean | – | Set true only after reconciling balances/hashes when the status reports money_moved true or unknown. |
| operation_id | string | yes | Operation id returned by start_fund_market, start_bring_home, or submit_arc_transfer. |
No output schema declared.
No examples provided.
review_agent_strategy_revision ~344
Compare one caller-owned saved agent's current strategy with one proposed revision on one shared historical dataset and a chronological cold-state holdout. The response includes exact strategy hashes, fees, slippage, evidence completeness, and holdout deltas. It never reveals the saved source, changes the agent, promotes the candidate, signs, funds, or submits orders; applying a revision always requires a separate explicit update_agent call.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_id | string | yes | Caller-owned saved agent UUID. |
| bars | integer | – | Exact shared historical bars. Defaults to 600. |
| candidate_strategy_id | string | yes | Owned Felix-generated candidate strategy UUID. Source code is never accepted. |
| capital | number | – | Fresh hypothetical capital for every replay phase. Defaults to 1000. |
| 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 | – | Bar interval. Defaults to 1h. |
| market | string | – | Required only when the saved agent authorizes multiple markets; it must be one of those markets. |
| min_holdout_trades | integer | – | Minimum candidate holdout trades before the comparison is decision-usable. Defaults to 1. |
| objective | string | – | Holdout comparison objective. Defaults to return over drawdown. |
| slippage_bps_per_side | number | – | Adverse movement applied to every simulated fill. Defaults to 0 bps. |
No output schema declared.
No examples provided.
revoke_polymarket_withdrawal_grant ~62
Revoke the stored Polymarket fixed-home withdrawal authorization for the account.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
No output schema declared.
No examples provided.
scan_options_flow ~116
Scan delayed consolidated equity-option chains for unusual volume/open-interest and premium. This is decision support, not tape-level sweep data.
| Name | Type | Req | Description |
|---|---|---|---|
| limit | integer | – | Maximum rows. |
| min_premium | integer | – | Minimum chain-derived premium in USD. |
| min_vol_oi | number | – | Minimum volume/open-interest ratio. |
| min_volume | integer | – | Minimum contract volume. |
| side | string | – | Optional call or put filter. |
| symbols | array | – | Optional stock/ETF watchlist. The active tier controls the maximum. |
No output schema declared.
No examples provided.
screen_markets ~56
Screen a bounded liquid stock/crypto universe by momentum, trend, RSI, volatility, and dollar volume.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | – | Optional stock or crypto filter. |
| limit | integer | – | Maximum rows. Defaults to 25. |
No output schema declared.
No examples provided.
search_markets ~97
Search across stocks, crypto, perps, options, and prediction markets with one fuzzy query. Use list_markets for complete venue enumeration.
| Name | Type | Req | Description |
|---|---|---|---|
| kind | string | – | Optional filter: crypto|stock|perp|option|pm. |
| limit | integer | – | Max results. Defaults to 20. |
| q | string | yes | Ticker, name, or question, e.g. bitcoin, NVDA, fed rate cut. |
No output schema declared.
No examples provided.
search_tokens ~160
Read-only discovery for candidate Solana and BNB Chain tokens through the optional token API. The engine returns token_evidence_unavailable when required provider evidence is missing. Contract or mint address is the identity; symbols are display text. Every result remains non-tradeable.
| Name | Type | Req | Description |
|---|---|---|---|
| chain | string | yes | Token chain. |
| limit | integer | – | Maximum rows. Defaults to 20. |
| minimum_liquidity_usd | number | – | Minimum reported liquidity. Defaults to 25000. |
| q | string | yes | Symbol, name, or exact contract/mint address, 2-64 characters. |
| verified_only | boolean | – | Require provider-verified identities. Defaults to true; BNB risk data is currently incomplete and therefore excluded by this default. |
No output schema declared.
No examples provided.
set_exit_plan ~172
Create or replace one encrypted, server-monitored OCO exit plan on an owned Hyperliquid or Derive position.
| Name | Type | Req | Description |
|---|---|---|---|
| break_even_after_pct | number | – | Profit fraction that activates a break-even exit. |
| idempotency_key | string | yes | Required retry-safety key. |
| max_holding_minutes | number | – | Maximum position age in minutes. |
| position_id | string | yes | Owned position UUID. |
| stop_loss_pct | number | – | Loss fraction from entry, e.g. 0.05 for 5%. |
| take_profit_pct | number | – | Profit fraction from entry, e.g. 0.10 for 10%. |
| trailing_activation_pct | number | – | Profit fraction required before trailing protection arms. |
| trailing_stop_pct | number | – | Trailing distance as a decimal fraction. |
No output schema declared.
No examples provided.
set_position_protection ~160
Set take-profit and/or stop-loss trigger prices on a position, optionally closing only part of it at each (percent 1-100). Pass the version from get_position_protection; a stale version is refused so app changes are never overwritten.
| Name | Type | Req | Description |
|---|---|---|---|
| position_id | string | yes | Position id. |
| stop_loss_percent | number | – | Percent of the position the stop-loss closes (default 100). |
| stop_loss_price | number | – | Trigger price on the loss side. |
| take_profit_percent | number | – | Percent of the position the take-profit closes (default 100). |
| take_profit_price | number | – | Trigger price on the profit side. |
| version | integer | yes | version from get_position_protection (0 when none is set). |
No output schema declared.
No examples provided.
settle_fees ~116
Legacy, not needed to trade. Deprecated compatibility alias for top_up_fee_balance. It adds prepaid credit; it does not settle debt and is never called by withdrawals.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_low_owner_buffer | boolean | – | Explicitly allow this top-up to leave owner USDC.e below the recommended trading buffer. Preview first. |
| amount_usd | number | yes | USDC.e amount to prepay for future live execution fees. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it after any timeout or restart. |
No output schema declared.
No examples provided.
start_arc_home_hl_return ~252
Start a durable Hyperliquid -> Arc home return: one owner-signed withdraw3 to the account's own Arbitrum wallet, then one Arc deposit into the account's verified Arc home Safe. Returns an operation_id immediately. For 5 to 25 USDC prefer arc_home_hypercore_return (direct, no Arbitrum: the route the app uses); this legacy route also needs FELIX_ARBITRUM_RPC_URL set to a private Arbitrum RPC. A refusal moves nothing. Completion means a finalized credit in the Arc home Safe. Reuse the same idempotency_key after any timeout; never start a second return to work around an uncertain one.
| Name | Type | Req | Description |
|---|---|---|---|
| accept_amount_adjustment | boolean | – | Accept a smaller amount if Felix must keep collateral reserved for open agent positions. |
| allow_high_fee_loss | boolean | – | Accept the proportionally high fixed fees of a return under $10. |
| amount_usd | number | yes | USDC to withdraw from Hyperliquid (at least 2). The Hyperliquid and Circle fees come out of it. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it for the exact return. |
No output schema declared.
No examples provided.
start_backtest ~198
Start a durable long-running backtest and return immediately with an operation_id. Poll get_backtest_operation; API restarts can be recovered with resume_backtest_operation.
| 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 fxbt operation key. Felix generates one when omitted. |
| 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.
start_bring_home ~194
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. |
| 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 for the exact operation. |
| resume_reconciliation | boolean | – | Resume only this exact previously reconciled workflow. |
| venue | string | yes | Source market account. |
No output schema declared.
No examples provided.
start_capital_move ~270
Start an explicitly confirmed, enclave-signed move of this account's own allocated capital. Supports funding Hyperliquid/Lighter/Polymarket from the trading pool and Relay returns from those venues to the owner's Arc Home. Derive and treasury moves are disabled: requires owner approval; not available via API key. confirm:true does not grant that approval. Review preview_capital_move first; preview_home_funding provides separate Home funding quote evidence, not a bound execution ceiling. Users pay the small Arc gas for these capital moves. Requires transfer scope and active capital setup. Retain the move ID and poll get_capital_move for worker reconciliation, transaction hashes, and terminal state. Reuse the same idempotency_key after any uncertain result.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| amount_usd | number | yes | Exact reviewed amount, with at most six decimal places. |
| confirm | boolean | yes | Must be true after reviewing availability, the amount and the owner-paid costs. |
| direction | string | yes | fund uses allocated capital; bring_home returns to Arc Home. |
| idempotency_key | string | yes | Required durable retry key. Preserve this key and the exact request after any timeout. |
| venue | string | yes | Venue. treasury is allowed only for bring_home. |
No output schema declared.
No examples provided.
start_fund_market ~178
Start durable funding to a currently certified venue and return immediately with an operation_id. Derive/options funding is under release hold and must not be started. Prefer this for the certified crypto bridge; monitor get_money_operation while the owner-signed route settles.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | yes | Amount to fund. |
| auto_swap_native_usdc | boolean | – | Automatically convert only the native Polygon USDC needed for this operation. Defaults to true. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it for the exact operation. |
| 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 | – | Resume only this exact previously reconciled workflow. |
| venue | string | yes | Target market account. |
No output schema declared.
No examples provided.
start_home_funding ~136
Prepare the allocation from a reviewed Home quote. Does not sign, move money or fund the venue. Returns an awaiting_owner_signature allocation; submit its locally signed Safe transaction separately, then read get_home_funding and explicitly confirm the exact start_capital_move continuation.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| confirm | boolean | yes | Must be true after the owner reviews this exact action. |
| idempotency_key | string | yes | Required durable retry key. Preserve it and the exact request after an uncertain result. |
| quote_token | string | yes | Opaque token from preview_home_funding. Keep private. |
No output schema declared.
No examples provided.
stop_agent ~25
Stop a caller-owned running agent.
| Name | Type | Req | Description |
|---|---|---|---|
| agent_id | string | yes | Agent UUID. |
No output schema declared.
No examples provided.
submit_arc_transfer ~307
Execute a Circle Gateway USDC transfer through Felix Arc settlement with the client-held owner key: approve and deposit on the source chain, sign the EIP-712 burn intent, mint on the destination chain, and reconcile until the funds are usable. Every transaction is signed locally and broadcast through the journey-scoped settlement relay, so no client RPC is needed. Returns immediately with an fxop_ operation_id; poll get_money_operation or wait_for_operation, and use get_arc_transfer for the server-side journey state. Finality can take 15-20 minutes when the source chain is not Arc.
| 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.
submit_capital_allocation ~151
Submit the already reviewed allocation using locally produced owner Safe signatures. This can move owner funds into the owner capital account. No private key or email code is accepted. Preserve the operation ID and key on timeout; read get_arc_home_operation rather than creating a replacement allocation.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| confirm | boolean | yes | Must be true after the owner reviews this exact action. |
| idempotency_key | string | yes | Required durable retry key. Preserve it and the exact request after an uncertain result. |
| operation_id | string | yes | Prepared allocation operation UUID. |
| safe_signatures | object | yes | Map of reviewed Safe transaction hash to locally produced owner signature. |
No output schema declared.
No examples provided.
submit_derive_onboarding ~114
Verify the owner's exact prepared Derive transactions after a browser wallet broadcasts them, or relay exact CLI-signed raw transactions.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| signed_raw_transactions | array | – | Alternative CLI flow: exact 0x signed raw transactions. Never provide a private key. |
| transaction_hashes | array | – | Three 0x transaction hashes returned by a browser wallet. |
No output schema declared.
No examples provided.
submit_polymarket_withdrawal_grant ~112
Store an owner-signed, fixed-home Polymarket withdrawal grant for venue-scoped policy checks. Never accepts a private key.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| message | string | yes | Exact message returned by prepare_polymarket_withdrawal_grant. |
| signature | string | yes | 0x-prefixed 65-byte owner personal-sign signature. |
No output schema declared.
No examples provided.
submit_venue_bootstrap ~114
Submit locally owner-signed bootstrap consent. Authorizes the exact prepared seed debits and may start background funding. Never infer consent from a deposit. Review seed amounts, recipients, expiry and total before confirming.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| confirm | boolean | yes | Must be true after the owner reviews this exact action. |
| consent | object | yes | – |
| 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.
submit_wallet_policy ~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). Relay an exact owner-signed Safe V3 policy transaction. Accepts only the sealed policy token and canonical Safe signature.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional child account UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| owner_signature | string | yes | 0x-prefixed 65-byte canonical EIP-712 signature. |
| policy_token | string | yes | Opaque sealed policy intent returned by prepare_wallet_policy. |
No output schema declared.
No examples provided.
submit_withdrawal ~107
Relay an owner-signed Safe withdrawal prepared by prepare_withdrawal. Accepts only the request id and 65-byte signature, never a private key.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| owner_signature | string | yes | 0x-prefixed 65-byte canonical EIP-712 signature. |
| request_id | string | yes | Prepared withdrawal UUID. |
No output schema declared.
No examples provided.
swap_native_usdc ~113
Convert Polygon native USDC into USDC.e. This is owner-signed, same-chain, may receive gas assistance, and normally happens automatically inside fund_market.
| Name | Type | Req | Description |
|---|---|---|---|
| amount_usd | number | – | Amount to swap. Defaults to the entire native USDC balance. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it after any timeout or restart. |
| resume_reconciliation | boolean | – | Set true only when resuming this exact interrupted workflow after reconciling its submitted transaction hash. |
No output schema declared.
No examples provided.
test_webhook ~45
Send a sample order.filled event to active webhooks.
| Name | Type | Req | Description |
|---|---|---|---|
| idempotency_key | string | – | Optional stable retry key; reuse it to avoid delivering a second test event. |
No output schema declared.
No examples provided.
top_up_fee_balance ~135
Legacy: sign one bounded USDC.e transfer locally and credit it as prepaid execution-fee credit (accounts with a Polygon owner wallet only). Not needed to trade: Felix's fee is charged from the trading account after each fill and never blocks an order.
| Name | Type | Req | Description |
|---|---|---|---|
| allow_low_owner_buffer | boolean | – | Explicitly allow this top-up to leave owner USDC.e below the recommended trading buffer. Preview first. |
| amount_usd | number | yes | USDC.e amount to prepay for future live execution fees. |
| idempotency_key | string | yes | Required workflow replay key. Reuse it after any timeout or restart. |
No output schema declared.
No examples provided.
update_agent ~457
Update a stopped/paused agent's generated strategy reference, name, cadence, risk limits, or server-monitored exits while retaining its UUID and history. Strategy revisions require a proven-flat position book and cannot resume in the same request; review the returned strategy hash, then resume separately.
| Name | Type | Req | Description |
|---|---|---|---|
| acknowledge_unvalidated | boolean | – | Explicitly acknowledge missing or degraded replay evidence for a live strategy revision. |
| agent_id | string | yes | Agent UUID. |
| break_even_after_pct | number | – | Optional break-even activation fraction. |
| budget_usd | number | – | Updated capital ceiling; cannot exceed the live key cap or approved portfolio envelope. |
| clear_exit_plan | boolean | – | Remove every server-monitored exit rule. Cannot be combined with individual exit-plan fields. |
| confirmed_budget_usd | number | – | Exact reviewed capital, required for live budget increases. |
| cycle_seconds | integer | – | Updated cadence. Polymarket minimum 5s; other venues 30s. |
| expected_current_strategy_sha256 | string | – | Optional current-strategy hash to bind the reviewed revision. |
| expected_strategy_sha256 | string | – | Optional expected replacement-strategy hash. |
| idempotency_key | string | – | Optional retry-safety key. Auto-generated when omitted. |
| max_daily_loss_usd | number|null | – | Exact daily-loss ceiling, or null to turn this named agent limit off. |
| max_holding_minutes | number | – | Optional maximum holding time. |
| max_position_usd | number|null | – | Exact position ceiling, or null to turn this named agent limit off. |
| name | string | – | Optional updated name, 1-80 characters. |
| replay_attestation | string | – | Replay attestation token for this exact replacement strategy. |
| resume | boolean | – | Restart the same agent after updating its policy. |
| stop_loss_pct | number | – | Optional live hard-stop fraction for venues with server-monitored exits. |
| strategy_id | string | – | Optional owned Felix-generated replacement strategy UUID. The agent must be stopped and have no open positions. |
| take_profit_pct | number | – | Optional profit target fraction. |
| trailing_activation_pct | number | – | Optional activation fraction. |
| trailing_stop_pct | number | – | Optional trailing distance fraction. |
No output schema declared.
No examples provided.
update_portfolio_mandate ~245
Atomically replace the caller-owned portfolio risk mandate, including optional per-underlying Derive Greek limits. Exact live Derive quotes enforce configured limits while allowing risk-reducing orders. This cannot widen API-key, owner-signed, venue, or agent limits. Requires the current version and a stable idempotency key.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. Omit for the active account. |
| allocation_targets | object | yes | Complete allocation target set. Values must add to exactly 100 percent. |
| derive_greek_limits | array | – | Optional per-underlying Derive gamma, theta, and vega limits. Omit to preserve; send [] to clear. Each row needs at least one limit. |
| expected_version | integer | yes | Current version from get_portfolio_mandate. |
| idempotency_key | string | yes | Stable 1-128 printable ASCII retry key. |
| limits | object | yes | Complete portfolio-risk limit set. Omitted or unknown limits are rejected. |
| mode | string | yes | Presentation mode. Both modes use the same server enforcement. |
| profile | string | yes | Guided preset or custom advanced policy. |
No output schema declared.
No examples provided.
update_wallet_policy ~185
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). Locally verify, sign, and relay a Safe V3 pause, resume, renewal, or emergency lockdown in one replay-safe workflow. Lockdown also 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 | yes | Required durable workflow key, 1-128 printable ASCII characters. |
| resume_reconciliation | boolean | – | Set true to retry the exact signed submission after reconciling an interrupted attempt. |
No output schema declared.
No examples provided.
upgrade_subscription ~104
Buy or renew 30 days of Felix Pro for exactly $20 in native Polygon USDC. The owner signs locally, auto-renew is off, and retries reconcile the original transaction instead of paying twice.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| idempotency_key | string | yes | Required stable payment workflow key. Reuse it after any interruption. |
| plan | string | yes | Must be pro; the price is fixed server-side at $20. |
No output schema declared.
No examples provided.
use_child_account ~111
Activate a previously created child account for this session by minting and installing its owner-signed live key. After this, fund_market/place_order/etc. operate on the child. The child owner key is derived locally and never reaches Felix.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | yes | Child account UUID to activate. |
| force_remint | boolean | – | Discard any cached credential for this child and mint a fresh one. Use after the account's scopes, caps, or mandate change; otherwise the cached key is reused. |
No output schema declared.
No examples provided.
verify_custody ~47
Verify this account's Safe owner, threshold, enabled V3 module, immutable bindings, and policy against Polygon chain state.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
No output schema declared.
No examples provided.
verify_withdrawal_confirmation ~92
Verify a locally supplied email code for the unchanged withdrawal intent. Returns an opaque withdrawal_confirmation proof for the existing withdrawal tools. Keep code/proof private. No signing or money movement.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| code | string | yes | Email code entered locally by the owner. |
| intent | object | yes | – |
| request_id | string | yes | Confirmation request UUID. |
No output schema declared.
No examples provided.
wait_for_events ~117
Long-poll durable account ledgers for agent decisions/errors and position opens/closes. One call replaces repeated polling and returns after an event or the bounded timeout.
| Name | Type | Req | Description |
|---|---|---|---|
| after | string | – | ISO-8601 cursor. Omit to wait only for new events. |
| event_types | array | – | Optional event filter. |
| limit | integer | – | Maximum returned events, 1-100. Defaults to 25. |
| wait_seconds | integer | – | Maximum long-poll wait, 0-25 seconds. Defaults to 20. |
No output schema declared.
No examples provided.
wait_for_operation ~113
Wait inside one MCP call for a money or backtest operation to finish, avoiding repeated LLM polling. Returns early on completion, failure, interruption, or reconciliation-required state.
| Name | Type | Req | Description |
|---|---|---|---|
| operation_id | string | yes | fxop_ money-operation id or fxbt_ backtest-operation id. |
| poll_interval_ms | integer | – | Internal poll interval, 250-5000ms. Defaults to 1000ms. |
| wait_seconds | integer | – | Maximum wait, 1-120 seconds. Defaults to 30. |
No output schema declared.
No examples provided.
walk_forward_backtest ~302
Compare two to four explicit strategy variants with anchored chronological training and untouched cold-start holdouts on one shared historical dataset. A robust verdict requires exact coverage, healthy full-length zero-error execution, nonnegative integer counters, historically replayable inputs, enough trades, and positive return in every holdout. Partial, degraded, malformed, or live-only evidence forces robust:false. Requires a stable idempotency key, includes explicit fees and slippage, and never signs, funds, deploys, or trades.
| Name | Type | Req | Description |
|---|---|---|---|
| bars | integer | – | Aligned historical bars split chronologically into training and holdout windows. |
| capital | number | – | Fresh starting capital for every training and holdout replay. |
| fee_bps_per_side | number | – | Execution fee applied to every simulated fill. |
| folds | integer | – | Number of chronological holdouts. |
| 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 variant. |
| min_train_trades | integer | – | Minimum clean training trades before a variant can be selected. |
| objective | string | – | Training-only selection objective. |
| slippage_bps_per_side | number | – | Adverse price movement applied to every simulated fill. |
| variants | array | yes | Two to four bounded strategy variants. |
| venue | string | – | Optional market-class hint. |
No output schema declared.
No examples provided.
withdraw ~266
Withdraw from the funded policy Safe or owner Polygon wallet. USDC.e withdrawals deliver bridged USDC.e on Polygon; many centralized exchanges do not support it, so prefer a self-custody Polygon wallet and convert to native USDC before an exchange deposit. Felix prepares one exact intent; the local owner key signs and the result is confirmed on-chain without exposing key material.
| Name | Type | Req | Description |
|---|---|---|---|
| account_id | string | – | Optional owned child account UUID. |
| address | string | yes | Owner address or confirmed allowlisted Polygon destination. |
| amount | number | yes | Amount in USD/token units. |
| chain | string | – | Chain. Defaults to polygon. |
| idempotency_key | string | yes | Required durable workflow key, 1-128 printable ASCII characters. |
| resume_reconciliation | boolean | – | Set true only to retry the exact prepared request after reconciling an interrupted submit. |
| source | string | – | auto|safe|owner_wallet. auto selects the Safe when funded and otherwise the owner wallet. |
| 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.
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.