Public.com MCP Server

An MCP (Model Context Protocol) server that connects AI assistants to your Public.com brokerage account. Trade stocks, options, and crypto — get quotes, manage orders, and view your portfolio — all through natural language.

Disclaimer: For illustrative and informational purposes only. Not investment advice or recommendations. Use at your own risk.

Tools

Read-Only

Tool	Description
check_setup	Verify API credentials and connectivity
get_accounts	List all brokerage accounts
get_portfolio	View positions, equity, buying power, open orders
get_orders	List active/open orders
get_order	Get status of a specific order
get_history	Transaction history (trades, deposits, dividends, etc.)
get_quotes	Real-time quotes for stocks, crypto, options
get_price_history	OHLCV price history for equities, crypto, options, or indices
get_instrument	Details about a specific tradeable instrument
get_all_instruments	List all available instruments with filters
get_option_expirations	Available expiration dates for options
get_option_chain	Full option chain (calls + puts) for a symbol
get_option_greeks	Greeks (delta, gamma, theta, vega, rho, IV) for multiple options
get_option_greek	Greeks for a single option symbol
preflight_order	Estimate costs/impact before placing a single-leg order
preflight_multileg_order	Estimate costs for multi-leg options strategies
preflight_short_order	Estimate costs before placing a short-sale order
preflight_call_credit_spread	Estimate costs for a Bear Call Spread
preflight_call_debit_spread	Estimate costs for a Bull Call Spread
preflight_put_credit_spread	Estimate costs for a Bull Put Spread
preflight_put_debit_spread	Estimate costs for a Bear Put Spread

Write (Destructive)

Tool	Description
place_order	Place a single-leg order (stocks, crypto, options)
place_multileg_order	Place multi-leg orders (spreads, straddles, etc.)
place_call_credit_spread	Place a Bear Call Spread
place_call_debit_spread	Place a Bull Call Spread
place_put_credit_spread	Place a Bull Put Spread
place_put_debit_spread	Place a Bear Put Spread
place_short_order	Place an equity short-sale order
flatten_and_go_short	Sell an existing long position then go short (experimental)
cancel_order	Cancel an existing order
cancel_and_replace_order	Atomically cancel and replace an order

Prerequisites

• Python 3.10+
• Public.com account — Sign up
• Public.com API key — Get one here

Installation

pip install publicdotcom-mcp-server

Or install from source:

git clone https://github.com/publicdotcom/publicdotcom-mcp-server.git
cd publicdotcom-mcp-server
pip install .

Configuration

Set your API credentials as environment variables:

# Required
export PUBLIC_COM_SECRET=your_api_secret_key

# Optional — sets a default account so you don't need to specify it each time
export PUBLIC_COM_ACCOUNT_ID=your_account_id

Usage

Claude Desktop

Add this to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "public-com": {
      "command": "publicdotcom-mcp-server",
      "env": {
        "PUBLIC_COM_SECRET": "your_api_secret_key",
        "PUBLIC_COM_ACCOUNT_ID":

... [View full README on GitHub](https://github.com/PublicDotCom/publicdotcom-mcp-server#readme)