ALPACA-MCP

# Alpaca API MCP Server ------ This MCP server provides an interface to the Alpaca trading API allowing you to trade stock, place trades, and access market information. Here is a list of "tools" it uses: `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. ## Installation ----- 1. Clone this repo 2. Install once using `npm install` - Reads the `package.json` and `package-lock.json` to install dependencies 3. For Development: `npm run dev` 4. To ship 1. `npm run build` - will execute the build script in the `package.json` 2. `npm start` - launches the development server on Node.js backend ## Connecting to Claude Desktop App ----- After running `npm run build` to build your server, you can test your MCP server using Claude as the client. After installing Claude for Desktop, the App configuration sits in `~/Library/Application Support/Claude/claude_desktop_config.json`. You can use the command `code ~/Library/Application\ Support/Claude/claude_desktop_config.json` to open this file. Now, you want to add the following to this json file for your MCP server. ``` Node { "mcpServers": { "alpaca": { "command": "node", "args": [ "/ABSOLUTE/PATH/TO/PARENT/FOLDER/alpaca/build/index.js" ] } } } ``` Save the file and restart Claude for Desktop. Once you launch you should see the hammer logo with your preloaded MCP toolkit/functions. Enjoy Trading! ## Contributions Contributions are welcome! Please fork this repository, make your changes, and open a pull request. ## License This project is licensed under the MIT License. ## Contact For issues, questions, and suggestions, create an issue in the repository or contact the maintainers through GitHub.