SIGN UPLOG IN
X (Twitter)LinkedInGitHubDiscordYouTube

How to connect Alpaca to Claude

Connect Claude Web, Desktop and Cowork to Alpaca MCP. Show your current alpaca positions, check latest aapl market price, and more using natural language, with authentication handled for you.

Get started for freeGet a demo
Alpaca logoAlpaca
Api KeyOauth2

Alpaca is a stock and crypto trading platform for commission-free trading, real-time market data, and algorithmic strategies. Use it to build brokerage apps, trading bots, and portfolio workflows with market connectivity.

100 Tools

Introduction

Claude is Anthropic's AI assistant, available on the web, in the desktop app, and on mobile. Cowork is its agent for knowledge work, and it runs on all of those surfaces too. Connected to your apps, Claude can work with your files and services to accomplish complex tasks on your behalf.

This guide walks you through the easiest and most secure way to connect your Alpaca account to Claude via Composio Connect, enabling it to show your current Alpaca positions, check latest AAPL market price, cancel all open Alpaca orders, and more such actions on your behalf without compromising your account security.

Setup is the same on Claude Web, Desktop, and Cowork, and you only need to do it once. The connector is tied to your account, so it's available in all three.

Also integrate Alpaca with

Codex

Connecting Alpaca to Claude Web, Desktop, and Cowork

Two ways to add the Composio connector. Pick whichever you prefer.

1. Add with one click

Click the button. Claude opens with the Composio connector filled in. Click Add, then go to step 2.

Add to Claude

Add manually

In Claude Desktop, click Customize in the left sidebar, then select Connectors and click the + icon at the top.

Claude Desktop connectors screen with Add custom connector selected

Click Add custom connector and paste in the Composio MCP server URL:

bash
https://connect.composio.dev/mcp
Add custom connector dialog with Composio MCP server URL

2. Authorize in your browser

Click Connect. You'll be redirected to a browser window where you can authorize Composio to continue.

Composio authorization screen for Claude Web, Desktop, and Cowork

3. Connect your Alpaca account

Back in Claude, ask it to connect to Alpaca or give it any Alpaca-related task.

For example, ask Claude to:

  • "Show your current Alpaca positions"
  • "Check latest AAPL market price"
  • "Cancel all open Alpaca orders"

It will prompt you to authenticate and authorize access.

That's it. Composio's tools are now available in Claude, and your Alpaca account is ready to use.

What is the Alpaca Claude Connector, and what's possible with it?

The Alpaca MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Alpaca account. It provides structured and secure access to your trading account and market data, so your agent can monitor positions, review orders, analyze portfolio history, manage watchlists, and track stock and crypto prices on your behalf.

  • Account and portfolio monitoring: Have your agent review account details, open positions, portfolio history, account activity, and trading settings.
  • Order and position management: Direct your agent to list filtered orders, cancel all open orders, or liquidate every open position at market price.
  • Stock market research: Instruct your agent to retrieve historical price and volume bars for one or more stocks, check market hours, and review the trading calendar.
  • Crypto market tracking: Let the agent fetch crypto quotes, historical bars, snapshots, order books, trades, and perpetual futures pricing for supported symbols.
  • Watchlist management: Have your agent create watchlists and add stocks or crypto assets to existing lists by symbol or watchlist name.

Troubleshooting

1. Why does Claude not use the Composio connector for Alpaca?

The connector can show as connected, but Claude must use it in each Alpaca conversation.

  • Click + at the lower left of the chat, or type /.
  • Hover Connectors.
  • Turn on Composio.
  • Ask Claude to connect to Alpaca again.

2. Why does Claude show an MCP server error before Alpaca connects?

Claude can show Couldn't reach the MCP server or Authorization with the MCP server failed when you add the connector for Alpaca.

  • Check that the connector URL is https://connect.composio.dev/mcp.
  • Connectors run from Anthropic's cloud, so your device network is usually not the problem.
  • Add the connector again from Customize > Connectors, then ask Claude to connect Alpaca.
  • If it fails again, send the error and the ofid_ reference id to support@composio.dev.

3. Why does the Alpaca authorization link not work?

The Composio connector is one server. Your Alpaca account connects separately when Claude asks for it.

  • If the browser does not open, or the link expires, ask Claude to retry the Alpaca connection.
  • Composio creates a fresh Alpaca authorization link.
  • Open that link in your browser and finish the Alpaca sign-in.

4. Why do Alpaca actions fail after they worked before?

The Alpaca connection can expire or lose permission.

  • Ask Claude to inspect the Alpaca connection.
  • If the connection is unhealthy, disconnect it when Claude prompts you.
  • Reconnect the Alpaca account and retry the action.
  • If Claude shows a permission prompt, approve it before Claude changes data in Alpaca.
  • If the action still fails with a permission error, check that the connected account has that permission in Alpaca itself.

5. How do I switch to a different Alpaca account?

Claude can manage the Alpaca connection for you.

  • Ask Claude to disconnect or delete the current Alpaca account.
  • Ask Claude to connect Alpaca again.
  • Open the new Composio authorization link for Alpaca.
  • Sign in with the other Alpaca account in the browser.
  • After the account connects, ask Claude to retry the Alpaca task.

6. Why is my Alpaca connection missing in Claude Desktop or on a Team plan?

The connector belongs to your Claude account, so your Alpaca connection works in Claude Web, Desktop, and Cowork.

  • In Claude Desktop, open Customize > Connectors.
  • Next to Composio, click ⋮ and click Clear cache.
  • If Alpaca tools still do not appear, click ⋮, disconnect, remove the connector, and add it again.
  • On Team or Enterprise, an Owner or Primary Owner must enable the connector before you can connect Alpaca.
TOOLS

Supported Tools

Every Alpaca action and event your agent gets out of the box.

Add Asset to Watchlist

Adds a ticker symbol to an existing watchlist identified by ID, for tracking a security.

Add Asset to Watchlist by Name

Add an asset to a watchlist by name.

Create Watchlist

Creates a new watchlist for the authenticated account.

Create Watchlist

Creates a watchlist for the authenticated account using the supplied name and symbols.

Delete All Open Positions

Liquidates all open positions at market, with an option to cancel open orders first.

Delete All Orders for Account

Attempts to cancel all open orders for a specified trading account and returns per-order results when provided.

Delete Unsubscribe Account

Delete a rebalancing subscription to unsubscribe an account.

Delete Watchlist By ID

Delete a watchlist by its unique identifier.

Get Account

Retrieves account information for the authenticated Alpaca account.

Get Account Activities

Retrieves account activities for the authenticated Alpaca account.

Get Account Activities V2

Retrieves account activities for the authenticated Alpaca account using the v2 API, including trade fills and non-trade activities.

Get Account Activities By Activity Type

Retrieves account activities of a specific type for the authenticated Alpaca account.

Get Account Configurations

Retrieves the current trading account configuration settings for the authenticated Alpaca account.

Get Account Portfolio History

Retrieves the portfolio history statistics for an Alpaca trading account.

Get Account Portfolio History

Retrieves the portfolio history statistics for a trading account.

Get All Account Positions

Bulk fetches all open positions for the authenticated account.

Get All Open Positions

Retrieves all open positions for the authenticated Alpaca trading account, including holdings and unrealized P&L.

Get All Orders

Retrieves all orders for an account based on specified filter criteria.

Get Historical Crypto US Bars

Retrieves historical OHLCV bars for crypto symbols at a selected location, aggregated by the specified timeframe.

Get Crypto Bars for Multiple Symbols

Retrieves historical OHLCV bars for multiple crypto symbols from the US market data location.

Get Stock Bars for Multiple Symbols

Retrieves OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols.

Get Historical Bars for Stock Symbol

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol.

Get Historical Stock Bars

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for a single stock symbol.

Get Calendar

Retrieves market calendar information for trading days from the Alpaca Trading API.

Get Clock

Retrieves the current market clock information from the Alpaca Trading API.

Get Stock Conditions

Retrieves the mapping of condition codes to their names from Alpaca Markets API for the specified type (trade or quote conditions) and tape.

Get Crypto Latest Quotes

Retrieves the latest bid and ask prices for specified crypto symbols at a specific location.

Get Crypto Perp Latest Bars

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for crypto perpetual futures symbols.

Get Crypto Perp Latest Orderbooks

Retrieves the latest bid and ask orderbook data for specified crypto perpetual futures symbols.

Get Crypto Perp Latest Pricing

Retrieves the latest pricing data for specified crypto perpetual futures symbols.

Get Crypto Perp Latest Quotes

Retrieves the latest bid and ask prices for specified crypto perpetual futures symbols for a specific location.

Get Crypto Perp Latest Trades

Retrieves the latest trade data for specified crypto perpetual futures symbols.

Get Crypto Perps Global Latest Bars

Retrieves the latest global OHLCV bars for crypto perpetual futures symbols, including trade count and volume-weighted average price.

Get Crypto Perps Global Latest Pricing

Retrieves the latest global pricing data for crypto perpetual futures symbols, including mark price, index price, open interest, and funding rate.

Get Crypto Perps Global Latest Quotes

Retrieves the latest global bid and ask quotes for specified crypto perpetual futures symbols.

Get Crypto Perps Global Latest Trades

Retrieves the latest trade data for specified crypto perpetual futures symbols.

Get Crypto Snapshots

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols in a specific location.

Get Crypto US Latest Bars

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for US crypto symbols.

Get Crypto US Latest Orderbooks

Retrieves the latest bid and ask orderbook data for specified crypto symbols in the US market.

Get Crypto US Latest Quotes

Retrieves the latest bid and ask prices for specified crypto symbols in the US location.

Get Crypto US Latest Trades

Retrieves the latest trade data for specified crypto symbols in the US location.

Get Crypto US Historical Quotes

Retrieves historical bid and ask quotes for specified crypto symbols in the US location, sorted by symbol and then timestamp.

Get Crypto US Snapshots

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols in the US market location.

Get Crypto US Trades

Retrieves historical trade data for specified US crypto symbols.

Get Exchanges

Retrieves a list of supported stock exchanges with their short codes and full names from the Alpaca Market Data API.

Get Latest Bar for Stock Symbol

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bar for a single stock symbol.

Get Latest Bars For Crypto Symbol

Retrieves the latest OHLCV bar for a cryptocurrency pair in Alpaca's US location.

Get Latest Bars for Crypto Symbols

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple crypto symbols.

Get Latest Bars for Multiple Stock Symbols

Retrieves the latest OHLCV (Open, High, Low, Close, Volume) bars for multiple stock symbols.

Get Crypto Latest Orderbooks

Retrieves the latest bid and ask orderbook data for specified crypto symbols.

Get Crypto Latest Quote

Retrieves the latest bid and ask prices for a specified crypto symbol.

Get Latest Quote for Stock Symbol

Retrieves the latest NBBO (National Best Bid and Offer) quote for a single stock symbol.

Get Crypto Latest Quotes

Retrieves the latest bid and ask prices for specified crypto symbols.

Get Latest Quotes for Multiple Stock Symbols

Retrieves the latest NBBO (National Best Bid and Offer) quotes for multiple stock symbols.

Get Latest Trade for Stock Symbol

Retrieves the latest trade data for a single stock symbol.

Get Latest Crypto Trades

Retrieves the latest trade data for specified crypto symbols.

Get Latest Trades for Multiple Stock Symbols

Retrieves the latest trade data for multiple stock symbols.

Get Market Calendar

Retrieves market calendar information for a specific exchange from the Alpaca Trading API.

Get Meta Exchanges

Retrieves US stock exchange identifiers and names from the Alpaca Market Data API.

Get Most Active Stocks

Retrieves the most active stocks by trading volume or trade count.

Get News

Retrieves news articles for specified crypto symbols from the Alpaca Market Data API.

Get Open Position

Fetches a single open position by symbol or asset ID.

Get Options Historical Bars

Retrieves historical OHLCV (Open, High, Low, Close, Volume) bars for options contracts.

Get Option Chain

Retrieves option-chain snapshots for an underlying symbol, with optional type, strike and expiration filters.

Get Option Contract

Retrieves an option contract by its OCC symbol or Alpaca ID, including contract specifications and available open interest and closing price information.

Get Option Latest Quotes

Retrieves the latest bid and ask prices for specified option symbols.

Get Options Meta Conditions

Retrieves the mapping of condition codes to their names from Alpaca Markets API for the specified tick type (trade or quote conditions).

Get Option Contracts

Retrieve option contracts from Alpaca Markets API (BETA).

Get Options Latest Trades

Retrieves the latest trade for each requested option contract symbol.

Get Options Meta Conditions Trade

Retrieves the mapping of trade condition codes to their names from Alpaca Markets API.

Get Options Snapshots

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple option contract symbols.

Get Options Snapshots by Underlying Symbol

Retrieves a page of option chain snapshots for an underlying symbol, with optional contract filters.

Get Options Historical Trades

Retrieves historical trade data for option contracts.

Get PDT Status

Retrieves Pattern Day Trader (PDT) status for the authenticated Alpaca trading account, including available PDT flags and call counts.

List account positions

Lists open positions for the authenticated trading account, including portfolio holdings and unrealized P&L.

Get Quotes for Multiple Stock Symbols

Retrieves historical quote (bid/ask) data for multiple stock symbols.

Get Quotes for Stock Symbol

Retrieves historical NBBO (National Best Bid and Offer) quotes for a specific stock symbol.

Get Stock Snapshot for Symbol

Retrieves a snapshot (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for a single stock symbol.

Get Crypto Snapshots

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple cryptocurrency symbols.

Get Stock Snapshots for Multiple Symbols

Retrieves snapshots (latest trade, latest quote, minute bar, daily bar, and previous daily bar) for multiple stock symbols.

Get Specific Announcement

Retrieves a specific corporate action announcement by its unique identifier.

Get Stock Auctions

Retrieves historical auction data for specified stock symbols.

Get Stock Auctions for Symbol

Retrieves historical auction (opening/closing print) data for a single stock symbol.

Get Stocks Meta Conditions Trade

Retrieves stock trade condition code names for a specified tape.

Get Subscription

Retrieves a rebalancing subscription by its unique ID.

Get Top Movers By Market Type

Retrieves the top market movers (gainers and losers) for a specified market type.

Get Trades for Multiple Crypto Symbols

Retrieves historical trade data for specified crypto symbols.

Get Trades for Multiple Stock Symbols

Retrieves historical trade data for multiple stock symbols.

Get Historical Trades for Stock Symbol

Retrieves historical trade data for a single stock symbol from Alpaca's market data API.

Get Watchlist By ID

Retrieves a single watchlist by its unique identifier.

Get Watchlist By Name

Retrieves a specific watchlist by its name.

Get Watchlists

Retrieves all watchlists associated with the authenticated account.

Update Account Configurations

Update the trading account configuration settings for the authenticated account.

Remove Asset From Watchlist

Removes a symbol from an existing watchlist in Alpaca.

Remove Symbol From Watchlist

Tool to remove a symbol from an existing watchlist in Alpaca.

Update Trading Configurations

Updates trading account configurations for an Alpaca trading account.

Update Watchlist By ID

Updates an existing watchlist by ID, supplying its name and optionally a replacement list of symbols.

Update Watchlist By Name

Updates an existing watchlist by its name.

Update Watchlist By Name (v2)

Updates an existing watchlist by its name.

Upload Account CIP Information

Upload CIP (Customer Identification Program) information for an account to complete identity verification.

FRAMEWORKS

How to build Alpaca MCP Agent with another framework

Codex logo

Codex

Use Alpaca MCP with Codex

FAQ

Frequently asked questions

With a standalone Alpaca MCP server, the agents and LLMs can only access a fixed set of Alpaca tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Alpaca and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Cowork fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Alpaca tools.

Yes, absolutely. You can configure which Alpaca scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Alpaca data and credentials are handled as safely as possible.

Start with Alpaca.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Alpaca tool your agent needs.Free to start.

Start building