Alpaca MCP Server

Name: Alpaca MCP Server
Author: idsts2670

@idsts2670

Repository

About Alpaca MCP Server

No overview available yet

#alpaca #trading #api #mcp #server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp_server_Alpaca_Trading_API": {
      "command": "python",
      "args": [
        "alpaca_mcp_server.py"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Alpaca MCP Server?

The Alpaca MCP Server is a Model Context Protocol server that allows LLMs like Claude to interact with the Alpaca trading API. It enables trading stocks, checking positions, fetching market data, and managing your account through natural language.

How to use Alpaca MCP Server?

Install Python 3.10+, clone the repository, install required packages (mcp, alpaca-py, python-dotenv), and create a .env file with your Alpaca API credentials. Run the server with python alpaca_mcp_server.py, then configure Claude for Desktop by adding the server to claude_desktop_config.json with the appropriate path and environment variables.

Key features of Alpaca MCP Server

Get real-time stock quotes and historical price data
Check account balances, buying power, and status
View current positions and their performance
Place market and limit orders through natural language
List, track, and cancel orders

Use cases of Alpaca MCP Server

Ask for your current account balance and buying power
Retrieve the latest stock quote for a symbol like AAPL
View the price history for a stock over a specified number of days
Buy or sell shares of a stock at market price or with a limit price
Cancel all open orders or close all open positions

FAQ from Alpaca MCP Server

What are the runtime requirements?

Python 3.10 or higher, along with the packages mcp, alpaca-py, and python-dotenv. You also need a valid Alpaca API key and secret key.

How does the server authenticate with Alpaca?

It uses API key authentication. You provide your Alpaca API key ID and secret key (via .env file or environment variables in the config). By default, the server uses Alpaca's paper trading environment.

Can I use real money trading instead of paper trading?

Yes. You can change from paper trading to real money trading by modifying the TradingClient initialization parameter paper=True to paper=False in the server code.

Where does my trading data reside?

All account and order data is stored on Alpaca's servers. The server only retrieves or sends data through their API; it does not store any data locally.