Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.phantom.com/llms.txt

Use this file to discover all available pages before exploring further.

Stay up to date with the latest SDK releases, new features, and important announcements for Phantom developers.

​
Changelog

​
Week of April 27, 2026

​
Updates

  • Phantom Connect SDKs v2.0.2. The React SDK, Browser SDK, React Native SDK, and Server SDK have been bumped to v2.0.2. This is a maintenance release with internal package upgrades and dependency updates. To upgrade: 
    npm install @phantom/react-sdk@latest
  • Phantom CLI, MCP Server, and OpenClaw Plugin v1.2.7. The CLI, MCP Server, and OpenClaw plugin have all received a coordinated patch release that upgrades shared internal packages, improves command argument handling, and returns a typed, schema-validated result from simulate_transaction. To upgrade: 
    npm install @phantom/cli@latest @phantom/mcp-server@latest @phantom/phantom-openclaw-plugin@latest
  • Public Connect SDK repository updated. The open-source phantom-connect-sdk repository has been resynced with the latest internal changes so the published source matches the latest npm packages.

​
Week of April 20, 2026

​
Updates

  • App ID and Client ID support in the OpenClaw plugin. The OpenClaw plugin now accepts PHANTOM_APP_ID and PHANTOM_CLIENT_ID in its configuration. If you registered your app in the Phantom Portal, you can pass your App ID so that tool calls are attributed to your application.
  • Deferred authentication in the OpenClaw plugin. The plugin no longer attempts to authenticate when it loads. Authentication is deferred until the first tool call, which speeds up agent startup and avoids errors in environments where a browser is not immediately available.
  • Bitcoin provider deprecation notice. The window.phantom.bitcoin provider will be deprecated in an upcoming release. If your app uses the Bitcoin injected provider, you should begin migrating to Wallet Standard. See the Bitcoin integration guide for details on both approaches.
  • Phantom Connect SDK repo sync. The public phantom-connect-sdk repository has been updated with the latest internal changes. This keeps the open-source codebase in sync with the latest shipped versions of the React SDK, Browser SDK, and React Native SDK. The CLI, MCP Server, and OpenClaw plugin are versioned separately — see the release block below.

​
Phantom CLI v1.2, MCP Server v1.2, and OpenClaw Plugin v1.2 — April 2026

Affected packages: @phantom/cli, @phantom/mcp-server, @phantom/phantom-openclaw-plugin

​
Updates

  • Stricter tool input validation. All tool inputs are now validated with typed schemas instead of loose JSON Schema checks. Invalid parameters are caught earlier with clearer error messages, reducing failed tool calls for both CLI users and AI agents.
  • MCP Server and OpenClaw Plugin now powered by the CLI. The MCP Server and OpenClaw plugin now import all tools directly from @phantom/cli. This means bug fixes and improvements to any tool are immediately available across all three surfaces — terminal, MCP agents, and OpenClaw agents — without separate releases.
  • Improved OpenClaw plugin session handling. The OpenClaw plugin now creates its own session manager instance during tool registration, improving reliability when multiple tools run concurrently in the same agent session.
To upgrade: 
npm install @phantom/cli@latest @phantom/mcp-server@latest @phantom/phantom-openclaw-plugin@latest
See the CLI documentation, MCP Server setup guide, and tool reference for details.

​
Phantom CLI v1.0.0, MCP Server v1.1.0, and OpenClaw Plugin v1.1.0 — April 2026

Affected packages: @phantom/cli, @phantom/mcp-server, @phantom/phantom-openclaw-plugin

​
New features

  • Phantom CLI. The new @phantom/cli package gives you a standalone terminal interface for your Phantom wallet. Sign transactions, transfer tokens, swap across chains, and trade Hyperliquid perpetuals — all from the command line. Authenticate once with phantom login and your session refreshes automatically. See the CLI documentation for the full command reference.
  • MCP server mode built in. Run phantom --mcp to start the CLI as an MCP stdio server, exposing every command as a tool for AI agents. The @phantom/mcp-server package (now v1.1.0) wraps this mode in a dedicated binary for agents that need a standalone entry point.

​
Updates

  • Unified architecture. The MCP Server now delegates to the CLI for all wallet operations. This means both surfaces share the same tools and stay in sync automatically — any improvement to the CLI is immediately available to MCP agents.
  • Improved OpenClaw plugin session handling. The OpenClaw plugin now uses a shared session manager, improving reliability when multiple tools run in the same agent session.
See the CLI documentation, MCP Server setup guide, and tool reference for details.

​
Phantom Connect SDKs v2.0.1 — Stable release - April 2026

Affected SDKs: React SDK, Browser SDK, React Native SDK, Server SDK
The Phantom Connect SDKs v2.0.1 is the first stable release of the 2.0 line. The v2.0.0-beta.0 introduced OAuth2 PKCE-based authentication; this release graduates that to stable and includes a performance improvement that speeds up wallet connections. To upgrade from the beta or from 1.x: 
npm install @phantom/react-sdk@latest

​
Updates

  • Faster wallet connections. The SDKs no longer fetch all organization wallets during the connection flow. Wallet resolution now uses a direct tag-based lookup, which reduces latency — especially for accounts with many wallets.
  • More reliable token refresh. Access tokens are now refreshed synchronously before API calls instead of in the background, preventing rare cases where an expired token could reach the server.
See the React SDK, Browser SDK, React Native SDK, or Server SDK documentation to get started.

​
Phantom MCP Server and OpenClaw Plugin — Text-mode login and usability improvements - April 2026

The Phantom MCP Server and OpenClaw plugin now support text-mode authentication and include several usability improvements for AI agents.

​
New features

  • Text-mode login. The phantom_login tool now accepts a displayMode parameter. Set it to "text" to receive the device authorization URL and code as text instead of opening a browser — useful for headless or remote environments where a browser is not available.
  • Version reporting. get_connection_status now includes mcpServerVersion (MCP Server) or openClawPluginVersion (OpenClaw plugin) in its response, making it easier to verify which version your agent is running.

​
Updates

  • Simplified tool inputs. The walletId parameter has been removed from get_perp_markets and transfer_tokens — the authenticated wallet is used automatically.
  • Improved balance tool guidance. get_token_balances now clarifies that it does not include Hyperliquid perpetuals account balances and suggests calling get_perp_account for perps exposure.
  • Lazy authentication in OpenClaw. The OpenClaw plugin no longer blocks on authentication during plugin registration. Authentication is deferred until the first tool call, which speeds up agent startup.

​
Bug fixes

  • Hyperliquid withdrawal bridge provider. Fixed the bridge provider identifier used in Hyperliquid spot withdrawals, resolving potential failures when bridging funds out.
See the setup guide and tool reference for full documentation.

​
Phantom MCP Server v1.0.4 and OpenClaw Plugin v1.0.3 - April 2026

The Phantom MCP Server v1.0.4 improves session handling, EVM reliability, and Hyperliquid withdrawals. The OpenClaw plugin v1.0.3 picks up the same fixes.

​
Updates

  • Reworked withdraw_from_hyperliquid_spot. Now uses a quote-first flow with dry-run preview before executing. Optionally receive a different token on the destination chain with the buyToken parameter. This brings the total tool count to 29. See the tool reference for details.
  • Improved automatic token refresh. Read-only and idempotent tools are now retried automatically after a token refresh; other tools return a simple “retry now” response instead of requiring full re-authentication.
  • Improved EVM transaction reliability. transfer_tokens now fetches gas estimates, gas prices, and nonces in parallel, reducing latency and avoiding stale-nonce errors on busy networks.

​
Phantom MCP Server v1.0.3 - April 2026

The Phantom MCP Server v1.0.3 adds automatic session refresh, Hypercore explorer links, and several reliability improvements.

​
New features

  • Automatic session refresh. Expired OAuth sessions are now refreshed automatically in the background. Previously, an expired token required full re-authentication. Now, the MCP Server detects 401 errors, refreshes the token, and retries the request — so your workflow is not interrupted.
  • Hypercore explorer links. Transaction results for swaps targeting Hypercore/Hyperliquid L1 now include a link to the Hyperliquid explorer.

​
Updates

  • Simplified tool inputs. Several tools no longer require an optional walletId parameter — the authenticated wallet is used automatically.
  • OpenClaw plugin. The @phantom/phantom-openclaw-plugin now sends analytics headers and supports dynamic OAuth token refresh, improving session reliability for OpenClaw agents.

​
Bug fixes

  • EVM token transfers. Fixed a race condition in EVM transfers where the transaction nonce was not fetched before signing, which could cause failures under concurrent usage.
See the setup guide and tool reference for full documentation.

​
Phantom MCP Server v1.0.2 — Stable release - April 2026

The Phantom MCP Server v1.0.2 is the first stable release with 28 tools across wallet operations, swaps, and perpetuals trading.

​
What’s new in v1.0

  • No fees on swaps. All swaps executed through buy_token and portfolio_rebalance are fee-free — no transaction fees, platform fees, or commission.
  • Cross-chain swaps. buy_token supports Solana ↔ EVM swaps in both directions, including targeting Hypercore/Hyperliquid.
  • Perpetuals trading on Hyperliquid. Full trading lifecycle — open/close positions, manage leverage, view markets and history. See below for details.
  • Transaction simulation. simulate_transaction previews asset changes, security warnings, and blocking conditions without submitting on-chain.
  • ERC-20 allowance checking. get_token_allowance checks whether an approval is needed before a swap.
  • Reworked Hyperliquid funding flow. deposit_to_hyperliquid and withdraw_from_hyperliquid_spot now use a quote-first flow, support more destination chains (Solana, Ethereum, Base, Arbitrum, Polygon), and can receive non-USDC tokens via the buyToken parameter.
  • OpenClaw plugin. The new @phantom/phantom-openclaw-plugin package brings Phantom wallet tools directly into OpenClaw agents.
See the setup guide and tool reference for full documentation.

​
Phantom MCP Server — Perpetuals trading and transaction simulation (beta) - April 2026

These features are now stable in v1.0.2. See the entry above for the latest.
The Phantom MCP Server added perpetuals trading on Hyperliquid and transaction simulation in the 1.0.0-beta.0 prerelease, bringing the tool count from 13 to 25.

​
Perpetuals trading on Hyperliquid

Your AI assistant can now trade perpetual futures on Hyperliquid directly through the MCP Server. New tools cover the full trading lifecycle:
  • Account and market data — get_perp_account, get_perp_markets, get_perp_positions, get_perp_orders, and get_perp_trade_history for reading account balances, available markets, open positions, active orders, and historical trades.
  • Trading — open_perp_position and close_perp_position for opening and closing positions with configurable leverage, margin type, and order type (market or limit). cancel_perp_order cancels open orders.
  • Position management — update_perp_leverage to change leverage and margin type (cross or isolated) per market.
  • Funding — deposit_to_hyperliquid bridges assets to Hyperliquid, transfer_spot_to_perps moves USDC from your spot account into the perps account, and withdraw_from_perps transfers USDC back out.

​
Transaction simulation

The new simulate_transaction tool previews the effects of a transaction — including expected asset changes, security warnings, and blocking conditions — without submitting anything on-chain. Available for both Solana and EVM transactions.

​
ERC-20 token allowance checking

The new get_token_allowance tool returns the ERC-20 allowance granted by an owner to a spender on any supported EVM chain. Use it before a swap to check whether an approval transaction is needed. See the Phantom MCP Server documentation to get started.

​
Phantom MCP Server v1.0 — GA release - April 2026

See v1.0.2 above for the latest stable release and cumulative feature list.
The Phantom MCP Server has graduated from beta to a stable release. If you were using the 1.0.0-beta.0 prerelease, install the stable version: 
npx -y @phantom/mcp-server@latest

​
Dedicated agent wallets

Agents now receive their own dedicated wallet when they authenticate, instead of connecting to your personal wallet. This means agents must be funded before they can perform on-chain actions. After authenticating, use get_wallet_addresses to check the agent’s wallet address and send funds to it.

​
Cross-chain swaps

The buy_token tool now supports swaps between Solana and EVM chains (Ethereum, Base, Polygon, Arbitrum), in addition to same-chain swaps. Pass a different buyChainId than sellChainId to initiate a cross-chain swap.

​
Phantom Connect SDK — now open source - April 2026

The Phantom Connect SDK source code is now publicly available on GitHub at github.com/phantom/phantom-connect-sdk. The repository includes all Phantom Connect packages: You can browse the full implementation, open issues, and submit pull requests.

​
Phantom Connect SDKs v2.0 (beta) - April 2026

Affected SDKs: React SDK, Browser SDK, React Native SDK
The Phantom Connect SDKs are now available as a 2.0.0-beta.0 prerelease with an updated authentication flow. The new auth system uses an OAuth2 PKCE-based flow for improved security and session management. To try the beta, install the prerelease version from npm: 
npm install @phantom/react-sdk@beta
See the React SDK, Browser SDK, or React Native SDK documentation to get started.

​
Phantom MCP Server v0.2.4 - March 2026

The Phantom MCP server has been updated to v0.2.4 with 3 new tools, bringing the total from 10 to 13.

​
Portfolio rebalancing

The new portfolio_rebalance tool lets your AI assistant analyze your current Solana portfolio allocation and rebalance it to target percentages via token swaps. Supports dry-run mode to preview the swap plan before executing.

​
Other new tools

  • phantom_login — Re-authenticate, switch accounts, or refresh an expired session
  • pay_api_access — Pay for daily API access when quota is consumed
See the Phantom MCP server documentation to get started.

​
Phantom MCP server v0.2.1 - March 2026

The Phantom MCP server has been updated to v0.2.1 with expanded multi-chain support. The tool set has grown from 5 to 10 tools, adding dedicated EVM transaction signing, EIP-191 and EIP-712 message signing, token balance retrieval, and a connection status check. transfer_tokens now works across both Solana and EVM chains. See the Phantom MCP server documentation to get started.

​
Phantom Connect v1.0.7 - March 2026

Affected SDKs: React SDK, Browser SDK, React Native SDK

​
New features

Dapp-sponsored transactions All three SDKs now support dapp-sponsored transactions for Solana, enabling double-signing flows where your backend co-signs a transaction before Phantom finalizes it. This is ideal for dapp fee-payer use cases where your app covers transaction fees on behalf of users. Learn how to implement dapp-sponsored transactions in the sign-and-send transactions guide for the React SDK, Browser SDK, or React Native SDK.

​
Phantom Cursor plugin - March 2026

The Phantom Cursor plugin is now available on the Cursor Marketplace. Install it to give your AI coding agent wallet capabilities, SDK knowledge, and Phantom best practices directly in Cursor. The plugin bundles subagents, skills, rules, and MCP servers into a single install. Your agent can scaffold complete Phantom Connect projects, write integration code that follows best practices, execute wallet operations across Solana, Ethereum, Bitcoin, and Sui, and search Phantom documentation in real time. Install from the Cursor Marketplace or learn more in the Cursor plugin documentation.

​
Phantom Connect v1.0.2 - January 15, 2026

Affected SDKs: React SDK, Browser SDK, React Native SDK

​
Bug fixes

Detect account changes when using injected provider Fixed an issue where the SDK wouldn’t detect when users switch accounts in their injected wallet provider (for example, Phantom extension). The SDK now automatically detects account changes and updates the connection state accordingly. Improved wallet detection for mobile wallets Fixed an issue where mobile wallets weren’t properly detected and displayed in the wallet discovery list. The SDK now correctly detects and displays all available mobile wallets. Prevent connection to unsupported networks Fixed an issue where the SDK would attempt to connect to networks that aren’t supported by certain wallet providers, which could cause connection errors. The SDK now correctly validates network support before attempting connections.

​
December 2025

​
Phantom Connect SDK MCP server

Your AI coding assistant can now search Phantom documentation directly. The Phantom Connect SDK MCP server gives Cursor, VS Code, Claude, and Claude Code real-time access to our docs for accurate answers while you code. Use the contextual menu on any docs page to auto-install, or check out the Phantom Connect SDK MCP server setup guide.

​
Spending limits

Users can now set spending limits when connecting to apps via Phantom Connect. This security feature allows users to control how much an app can spend on their behalf, with on-chain enforcement. Learn more in the spending limits documentation.

​
Phantom Connect SDKs

The Phantom Connect SDKs provide a streamlined way to integrate Phantom wallet functionality into your applications. Check out the SDK documentation: