Alpaca

TypeScript MCP server that exposes Alpaca’s REST API via stdio/stdout for real‑time market data, order management, portfolio insights, and more.

typescript

3

GitHub Stars

typescript

Language

4 months ago

First Indexed

3 weeks ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "wlu03-alpaca-mcp-server": {
      "command": "node",
      "args": [
        "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca/build/index.js"
      ]
    }
  }
}

This MCP Server exposes the Alpaca trading API through a structured, programmable interface, letting you programmatically access market data, manage orders and positions, and place trades from your MCP client. It is useful for automating trading workflows, building dashboards, and integrating Alpaca capabilities into your own tools.

How to use

You connect to this server from an MCP client to perform trading actions and retrieve account data. Use the client’s MCP integration to load and run the Alpaca MCP server, then call its available endpoints to fetch account details, place or modify orders, manage watchlists, pull market data, and review historical performance. Each tool corresponds to a specific Alpaca action, such as creating orders, retrieving positions, or fetching quotes.

How to install

Prerequisites you need on your machine:

Node.js and npm must be installed on your system
A terminal or command prompt with access to the internet

Step-by-step setup:

Clone the project repository where the Alpaca MCP Server lives
Install dependencies with npm install
Build the server for production or test with npm run build (optional for development)
Start the server with npm start for a production-like run or npm run dev for development

Additional notes

The server includes a development workflow where you build the server and then run the resulting Node.js backend. You can test compatibility with Claude Desktop by loading a preconfigured MCP server entry that points to the built index. Use the provided JSON snippet to register the server in Claude’s configuration, then restart Claude Desktop to load the Alpaca MCP toolkit.

Available tools

get-alpaca-account

Fetches your Alpaca account details.

alpaca-createOrder

Places a new order on Alpaca (buy/sell).

alpaca-getOrder

Retrieves a single order by its ID.

alpaca-getOrders

Lists orders with optional filters (status, limit, direction).

alpaca-replaceOrder

Modifies an existing order’s quantity or limit price.

alpaca-cancelOrder

Cancels a specific order by ID.

alpaca-cancelOrders

Cancels all open orders at once.

alpaca-getPosition

Retrieves details for a specific position.

alpaca-getPositions

Lists all current positions in your account.

alpaca-closePosition

Closes a specific position by symbol or asset ID.

alpaca-closePositions

Closes all open positions.

alpaca-exerciseOption

Exercises a specified option contract.

alpaca-getWatchlist

Retrieves a single watchlist by ID.

alpaca-getWatchlists

Lists all your watchlists.

alpaca-createWatchlist

Creates a new watchlist with given symbols.

alpaca-updateWatchlist

Updates an existing watchlist’s name and symbols.

alpaca-deleteWatchlist

Deletes a watchlist by ID.

alpaca-getPortfolioHistory

Fetches historical portfolio performance data.

alpaca-getActivity

Retrieves a specific account activity record.

alpaca-getActivities

Lists all account activity records.

alpaca-getOptionsContract

Retrieves details for one options contract.

alpaca-getOptionsContracts

Lists options contracts with filters.

alpaca-getCorporateAction

Retrieves a specific corporate action event.

alpaca-getCorporateActions

Lists corporate actions within a date range.

alpaca-getStocksCorporateActions

Lists corporate actions for stocks.

alpaca-getNews

Fetches news articles for specified symbols.

alpaca-getStocksMostActives

Lists the most active stocks by volume or change.

alpaca-getStocksMarketMovers

Lists top market movers by volume or change.

alpaca-getStocksQuotes

Retrieves quotes for specified symbols.

alpaca-getStocksQuotesLatest

Retrieves the latest quotes for symbols.

alpaca-getStocksSnapshots

Fetches snapshot data for symbols.

alpaca-getStocksConditions

Retrieves tick condition codes for trades or quotes.

alpaca-getStocksExchangeCodes

Lists available stock exchange codes.

alpaca-getStocksTrades

Retrieves trade data for specified symbols.

alpaca-getStocksTradesLatest

Retrieves the latest trade data for symbols.