Alpaca Trading MCP Server
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Alpaca Trading MCP Server show me my current portfolio positions"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Alpaca Trading MCP Server
A Model Context Protocol (MCP) server that provides an interface to the Alpaca trading API, allowing you to manage your stock and crypto portfolio, place trades, and access market data.
Features
Account Management: View account details, balances, and portfolio status
Trading: Place market, limit, stop, and stop-limit orders
Portfolio Management: View positions, calculate performance, and close positions
Market Data: Access real-time quotes and historical price data
Asset Information: Get details about tradable assets
Related MCP server: Alpaca MCP Server
Installation
Installing via Smithery
To install Alpaca Trading MCP Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @laukikk/alpaca-mcp --client claudeManual Installation
Clone this repository
Install dependencies:
pip install -e .Or using uv:
uv pip install -e .Configuration
Copy the
.env.examplefile to.env:
cp .env.example .envAdd your Alpaca Paper Trading API credentials to the
.envfile:
ALPACA_PAPER_API_KEY = "your-api-key"
ALPACA_PAPER_API_SECRET = "your-api-secret"You can obtain these credentials by creating an account at Alpaca.
Usage
Run the MCP server:
python src/server.pyThe server will start and be available for MCP clients to connect to.
Testing with Claude for Desktop
Configuration:
Open your Claude for Desktop App configuration in a text editor. Create the file if it doesn't exist.
Windows:
%APPDATA%\Claude\claude_desktop_config.jsonMac:
~/Library/Application\ Support/Claude/claude_desktop_config.json
Add the Alpaca MCP server configuration:
{
"mcpServers": {
"alpaca": {
"command": "uv",
"args": [
"--directory",
"/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca-mcp-server",
"run",
"src/server.py"
]
}
}
}MCP For Server Developers: Quickstart
Available Resources
The server provides the following resources:
account://info- Get current account informationpositions://all- Get all current positionspositions://{symbol}- Get position details for a specific symbolorders://recent/{limit}- Get most recent orders with specified limitmarket://{symbol}/quote- Get current market quote for a specific symbolmarket://{symbol}/bars/{timeframe}- Get historical price bars for a symbol with specified timeframeassets://list- List tradable assets available on Alpacaassets://{symbol}- Get detailed asset information by symbol
Available Tools
The server provides the following tools:
get_account_info_tool- Get current account informationplace_market_order- Place a market order to buy or sell a stockplace_limit_order- Place a limit order to buy or sell a stock at a specified priceplace_stop_order- Place a stop order to buy or sell a stock when it reaches a specified priceplace_stop_limit_order- Place a stop-limit order combining stop and limit order featurescancel_order- Cancel an open order by its IDclose_position- Close an open position for a specific symbolget_portfolio_summary- Get a comprehensive summary of the portfolio
Available Tools
8 toolscancel_orderB
Cancel an open order by its ID.
Args: order_id: ID of the order to cancel
Returns: Confirmation of cancellation
Inputs: order_id (required).
close_positionC
Close an open position for a specific symbol.
Args: symbol: Stock symbol to close position for
Returns: Confirmation of position closure
Inputs: symbol (required).
get_account_info_toolB
Get current account information.
Returns: Account summary with balance and status
Inputs: no named parameters.
get_portfolio_summaryB
Get a comprehensive summary of the portfolio including account details and open positions.
Returns: Portfolio summary with account and positions information
Inputs: no named parameters.
place_limit_orderB
Place a limit order to buy or sell a stock at a specified price.
Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell' limit_price: Maximum price for buy or minimum price for sell time_in_force: Order duration - 'day', 'gtc' (good till canceled), 'ioc' (immediate or cancel)
Returns: Order confirmation details
Inputs: symbol (required), quantity (required), side (required), limit_price (required), +1 more.
place_market_orderB
Place a market order to buy or sell a stock.
Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell'
Returns: Order confirmation details
Inputs: symbol (required), quantity (required), side (required).
place_stop_limit_orderA
Place a stop-limit order combining stop and limit order features.
Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell' stop_price: Price that triggers the order limit_price: Maximum/minimum price for the triggered order time_in_force: Order duration - 'day', 'gtc' (good till canceled)
Returns: Order confirmation details
Inputs: symbol (required), quantity (required), side (required), stop_price (required), +2 more.
place_stop_orderA
Place a stop order to buy or sell a stock when it reaches a specified price.
Args: symbol: Stock symbol (e.g., 'AAPL') quantity: Number of shares to buy or sell (can be fractional) side: Either 'buy' or 'sell' stop_price: Price that triggers the order time_in_force: Order duration - 'day', 'gtc' (good till canceled)
Returns: Order confirmation details
Inputs: symbol (required), quantity (required), side (required), stop_price (required), +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 8 tools
Each tool has a clearly distinct purpose with no ambiguity. Order placement tools (market, limit, stop, stop-limit) are well-differentiated by order type, while account/portfolio tools and order/position management tools serve separate functions. An agent can easily distinguish between them based on their specific actions.
Most tools follow a consistent verb_noun pattern (e.g., cancel_order, close_position, place_market_order). However, get_account_info_tool deviates slightly with the '_tool' suffix, breaking perfect consistency. The naming is otherwise predictable and readable across the set.
With 8 tools, this server is well-scoped for trading operations. It covers essential functions like order placement (4 tools), order cancellation, position management, and account/portfolio queries. Each tool earns its place without being overly sparse or bloated for the domain.
The toolset provides strong coverage for core trading workflows: placing various order types, managing orders and positions, and viewing account/portfolio data. A minor gap exists in the lack of tools for modifying existing orders or retrieving specific order details, but agents can work around this with the available tools.
Maintenance
Related MCP Connectors
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Financial data MCP server for Claude, ChatGPT, Cursor and Codex. Real-time stock quotes, financial statements, options flow, SEC filings, insider trades, 13F holdings, macro data and market news from gloom.sh, the open-source Bloomberg Terminal alternative.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for OpenMM — exposes market data, account, trading, and strategy tools to AI agents
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server enabling LLMs like Claude to interact with the Alpaca trading API through natural language for stock trading, checking positions, fetching market data, and managing your account.28MIT
- AlicenseNot gradedqualityDmaintenanceA Model Context Protocol server that enables LLMs like Claude to interact with the Alpaca trading API, allowing for trading stocks, checking positions, fetching market data, and managing accounts through natural language.3MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server implementation for Alpaca's Trading API that enables LLMs to interact with Alpaca's trading infrastructure using natural language, supporting stock, options, and crypto trading, portfolio management, watchlists, and market data.4MIT

NINX MCP Serverofficial
AlicenseNot gradedqualityDmaintenanceA Model Context Protocol (MCP) server that provides financial trading tools and market analysis capabilities, enabling AI assistants to access real-time market data, execute trades, analyze portfolios, and perform comprehensive financial analysis.MIT