Alpaca MCP Server

by cesarvarela

Integrations

  • Supports configuration through environment variables loaded from a .env file, including API endpoints and authentication keys.

  • Supports source code management and local development workflow through git clone operations.

  • Enables installation, development, and publishing of the package through npm registry.

Alpaca MCP Server

Expose Alpaca Market Data & Broker API as MCP tools.

Installation

npm install alpaca-mcp

Local Development

git clone <repo-url> cd alpaca-mcp npm install

Environment Variables

Create a .env at project root with:

ALPACA_ENDPOINT=https://data.alpaca.markets ALPACA_BROKER_ENDPOINT=https://broker-api.alpaca.markets ALPACA_API_KEY=YOUR_ALPACA_API_KEY ALPACA_SECRET_KEY=YOUR_ALPACA_SECRET_KEY

Commands

  • start (dev): npm start (runs npx tsx index.ts)
  • build: npm run build (compiles to dist/)
  • run compiled: node dist/index.js

Usage

Once running, the MCP server listens on stdin/stdout. Use any MCP client or the CLI:

npm link # optional alpaca-mcp # starts server globally

Available Tools

  • get-assets { assetClass?: "us_equity" | "crypto" }
  • get-stock-bars { symbols: string[]; start: string; end: string; timeframe: string }
  • get-market-days { start: string; end: string }
  • get-news { start: string; end: string; symbols: string[] }

Each returns JSON in content[0].text or an error.

MCP Client Configuration

To integrate via mcp.config.json, add the following under the mcpServers key:

{ "mcpServers": { "alpaca-mcp": { "command": "npx", "args": [ "-y", "alpaca-mcp" ], "env": { "ALPACA_ENDPOINT": "https://data.alpaca.markets", "ALPACA_BROKER_ENDPOINT": "https://broker-api.alpaca.markets", "ALPACA_API_KEY": "<YOUR_API_KEY>", "ALPACA_SECRET_KEY": "<YOUR_SECRET_KEY>" } } } } ## Publishing ```bash npm publish

License

ISC

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

MCP server that exposes Alpaca Market Data & Broker API as tools, enabling access to financial data like stock bars, assets, market days, and news through the Message Control Protocol.

  1. Installation
    1. Local Development
      1. Environment Variables
        1. Commands
          1. Usage
            1. Available Tools
          2. MCP Client Configuration
            1. License

              Related MCP Servers

              • A
                security
                A
                license
                A
                quality
                A Model Context Protocol (MCP) server that provides real-time access to financial market data through the free Alpha Vantage API. This server implements a standardized interface for retrieving stock quotes and company information.
                Last updated -
                5
                30
                Python
                MIT License
                • Apple
              • -
                security
                F
                license
                -
                quality
                An MCP server implementation that integrates with Angle One APIs to provide standardized access to financial market data, trading operations, and portfolio management.
                Last updated -
                Python
              • -
                security
                A
                license
                -
                quality
                MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
                Last updated -
                216
                Python
                MIT License
                • Apple
              • -
                security
                A
                license
                -
                quality
                An MCP server that integrates with the AlphaVantage financial data API, providing access to stock market data, technical indicators, and fundamental financial information.
                Last updated -
                Python
                MIT License
                • Linux
                • Apple

              View all related MCP servers

              ID: k8u0hj5os7