API

Get Started

WelcomeQuickstartExamplesChangelogSDKs and Tools

Authorization

POSTCreate personal access token

List Accounts

GETGet accounts

Account Details

GETGet account portfolio v2GETGet history

Instrument Details

GETGet all instrumentsGETGet instrument

Market Data

POSTGet quotesPOSTGet option expirationsPOSTGet option chain

Order Placement

POSTPreflight single legPOSTPreflight multi legPOSTPlace orderPUTReplace orderPOSTPlace multileg orderGETGet orderDELETECancel order

Option Details

GETGet option greeks
HelpFeedback

Get Started

Claude Desktop: Connecting the Public MCP Server to Claude Desktop

Learn how to connect your Public.com brokerage account to Claude Desktop using the official Public MCP server. We'll walk through installation, configuration, and placing your first trade.

What You'll Do

Step 01

Install dependencies

Step 02

Add the Public MCP Server to Claude Desktop

Step 03

Retrieve portfolio data and place trades

What is Claude Desktop and MCP

Claude Desktop is Anthropic's native desktop application for macOS and Windows, bringing the full power of Claude directly to your computer. Claude Desktop supports the Model Context Protocol (MCP), an open standard that lets Claude securely connect to external tools, data sources, and services running on your machine.

MCP servers act as local bridges between Claude and the outside world. When you add an MCP server to Claude Desktop, Claude gains the ability to call tools provided by that server, without any data leaving your machine through a third party. This makes it well suited for sensitive use cases like brokerage access, where your API keys and account data stay local.

The Public MCP server exposes your Public.com brokerage account as a set of tools Claude can call directly. Once connected, you can ask Claude to pull live portfolio data, check quotes, research options chains, and execute trades — all through natural language, entirely within Claude Desktop.

Before You Get Started

  • →Download and install Claude Desktop for macOS or Windows. You may need a claude subscrition to run MCPs.
  • →You will need a Public.com brokerage account. Create one at public.com/signup.
  • →Once you create your Public brokerage account, you'll need a Public API key. Generate one by creating a new key and saving it.
1

Installing Dependencies

Note: The commands below are macOS-based. Windows equivalents may differ.

If you don't have Homebrew already installed on your machine, you can do so with the command:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Next, use Homebrew to install uv, a fast Python package manager required by the MCP server:

brew install uv
2

Adding the Public MCP Server to Claude Desktop

MCP servers are configured by editing Claude Desktop's configuration file. Open it by navigating to:

~/Library/Application Support/Claude/claude_desktop_config.json

If the file doesn't exist yet, create it. Add the following configuration, replacing YOUR_PUBLIC_COM_SECRET and YOUR_ACCOUNT_ID with your credentials from the prerequisites:

{
  "mcpServers": {
    "public-com": {
      "command": "uvx",
      "args": [
        "publicdotcom-mcp-server"
      ],
      "env": {
        "PUBLIC_COM_SECRET": "YOUR_PUBLIC_COM_SECRET",
        "PUBLIC_COM_ACCOUNT_ID": "YOUR_ACCOUNT_ID"
      }
    }
  }
}

Security Notice

Your API key is stored in plain text in this config file. Treat it like a password — do not share the file, commit it to source control, or expose it to others. It grants direct access to your brokerage account.

Save the file, then fully quit and relaunch Claude Desktop. On macOS, make sure to use Cmd + Q to fully quit rather than just closing the window.

After relaunch, click the + icon in the chat input, then select Connectors. You should see public-com listed and selected.

3

Verifying the Connection

To confirm everything is connected correctly, start a new conversation in Claude Desktop and ask it to fetch your account balance:

Can you show me my current account balance and buying power?

Claude will call the Public MCP server and return your live account data. You'll see it working in real time — Claude will indicate when it's calling a tool before returning the result.

If Claude doesn't return account data and instead responds that it doesn't have access to brokerage tools, double check that you fully quit and relaunched Claude Desktop after saving the config file and check to see if the connector is turned on.

4

Retrieving Portfolio Data and Placing Trades

With the MCP server connected, you can use natural language to interact with your entire Public account. Start by pulling your portfolio to get a full picture of your holdings:

How is my portfolio performing today?

You can then research a specific asset before trading. Here's how to pull the options chain for a ticker:

Show me the options chain for AAPL expiring next Friday

Once you've identified a contract, you can place an order. Claude will run a preflight check — estimating the total cost, buying power impact, and fees — before submitting anything live:

Can you place a buy order for 1 AAPL call option expiring next Friday at the $200 strike?

Important

Placing a trade through Claude Desktop is a real order using real money in your Public account. Review all preflight details carefully before confirming. Only proceed if you fully understand and accept the risks involved.

More things you can ask

  • What is the current price of TSLA?
  • Show me my recent transactions
  • What are my open orders?
  • Cancel my open AAPL order
  • What is my buying power?
  • Show me the Greeks for my current options positions
  • Find a good covered call opportunity on SPY based on my holdings

What's Next

You've connected your Public.com brokerage to Claude Desktop via the Public MCP server. From here you can ask Claude to research equities, pull options chains, analyze your portfolio against market data, and execute orders — all without leaving the conversation.

Because Claude Desktop runs locally, your API key and all brokerage data stay on your machine. You can also stack additional MCP servers alongside the Public one to give Claude access to other tools — news feeds, calendars, file systems, databases — making it straightforward to build richer, multi-source workflows.

For the full list of available tools and advanced configuration options, refer to the Public MCP Server GitHub repository.