Alpaca Mcp
What is Alpaca Mcp
Alpaca MCP is a server that exposes Alpaca Market Data and Broker API as MCP tools, allowing users to access financial market data and trading functionalities.
Use cases
Use cases include algorithmic trading, market analysis, portfolio management, and developing financial applications that require real-time market data.
How to use
To use Alpaca MCP, install it via npm with ‘npm install alpaca-mcp’, set up environment variables in a .env file, and run the server using ‘npm start’. You can interact with the server using any MCP client or command line interface.
Key features
Key features include retrieving assets, stock bars, market days, and news, all returning JSON formatted data. It supports both US equities and cryptocurrencies.
Where to use
Alpaca MCP can be used in financial technology applications, trading platforms, and data analysis tools where access to market data and trading capabilities is required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Overview
What is Alpaca Mcp
Alpaca MCP is a server that exposes Alpaca Market Data and Broker API as MCP tools, allowing users to access financial market data and trading functionalities.
Use cases
Use cases include algorithmic trading, market analysis, portfolio management, and developing financial applications that require real-time market data.
How to use
To use Alpaca MCP, install it via npm with ‘npm install alpaca-mcp’, set up environment variables in a .env file, and run the server using ‘npm start’. You can interact with the server using any MCP client or command line interface.
Key features
Key features include retrieving assets, stock bars, market days, and news, all returning JSON formatted data. It supports both US equities and cryptocurrencies.
Where to use
Alpaca MCP can be used in financial technology applications, trading platforms, and data analysis tools where access to market data and trading capabilities is required.
Clients Supporting MCP
The following are the main client software that supports the Model Context Protocol. Click the link to visit the official website for more information.
Content
Alpaca MCP Server
Expose Alpaca Market Data & Broker API as MCP tools.
Installation
Installing via Smithery
To install Alpaca Market Data Server for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @cesarvarela/alpaca-mcp --client claude
Manual 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(runsnpx tsx index.ts) - build:
npm run build(compiles todist/) - 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:
License
ISC
Dev Tools Supporting MCP
The following are the main code editors that support the Model Context Protocol. Click the link to visit the official website for more information.
