{"_id":"@alpaca-open-api/mcp","_rev":"8-0f27006d63aae54e063a32ffaaec586c","name":"@alpaca-open-api/mcp","dist-tags":{"rc":"0.1.0-rc.0","latest":"1.2.2"},"versions":{"0.1.0-rc.0":{"name":"@alpaca-open-api/mcp","version":"0.1.0-rc.0","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@0.1.0-rc.0","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-api-ts#readme","bugs":{"url":"https://github.com/yagop/alpaca-api-ts/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"5164cec8a1a7488134a907b51335519eb888604f","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-0.1.0-rc.0.tgz","fileCount":2,"integrity":"sha512-kaVqE9emWIGqoami6zLSxuxsbb13d8e1jAcuH8ApaHOvX+8wHE0yl2kiu/+qfVQ19sahnM4T+RpWYpud0IpD+Q==","signatures":[{"sig":"MEQCIDk5NvUC6bF487PlOm2wDe1NipSlqaEjf0Bjx4tFcyjxAiBN7/AYAHa1JW/Ia2Tga4x/aGMjgeHM6IAAnVWN0Ww9Xw==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":611471},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"f7fcf1749af5aad97a75089aba94ba5aba2ed3da","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-api-ts.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.13.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"0.1.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.1.0-rc.0_1781951744256_0.1409387270247069","host":"s3://npm-registry-packages-npm-production"}},"1.0.0":{"name":"@alpaca-open-api/mcp","version":"1.0.0","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@1.0.0","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"e20bcaa114e9de90fdad72646ad6ddf5374cd0d3","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.0.0.tgz","fileCount":2,"integrity":"sha512-9jacuNutmVKAg6lWVWhnWKYngDLiNK/SNf+ZW7y4KGATZSbqPV5bSBJf2Q75JUCphVOV3gm3ecjZF7rhroJajQ==","signatures":[{"sig":"MEUCIEjIh+YTuErY6Ax7IKWKNfGi3xNfBH+dzgTaWQ+/C4qxAiEAj2puiF/FiAz08+qyZgJ4CBHll5npBptMMKeAbCHbhHk=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":611467},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"ad30020c061033f6942d0940bf0b5369e623bf85","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-open-api.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.13.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"1.0.0"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.0_1781965939688_0.9973002716646213","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@alpaca-open-api/mcp","version":"1.0.1","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@1.0.1","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"19be20683193bb7df72100c1720eade877c7b417","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.0.1.tgz","fileCount":3,"integrity":"sha512-dL4ryWHEyh2YYKPuZeGBUJLnRwQaOWyw/FJB1R6nyYmECQ0DXfs+37+jEFrF7A2k8j7IWxKXdZaDsDZsPSmmzg==","signatures":[{"sig":"MEUCICUH+S1/HmqFZT5nlnJqQBwWsPTPYjl8RUwuOIRdwIADAiEAk1lAvKZo8dF3hIm4khk7Muqd3BzGZA7jcCHTYWbUqe0=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alpaca-open-api%2fmcp@1.0.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":614420},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"9bbc00538635b6b71704a653b189b5fe109f8517","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-open-api.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.13.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.16.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"1.0.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.1_1781968433649_0.4317696589741271","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@alpaca-open-api/mcp","version":"1.0.2","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@1.0.2","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"b32679758cd1d357c85259732a997d08d886ead1","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.0.2.tgz","fileCount":3,"integrity":"sha512-WCyfpr5H0ZXCz028dSj7sDsBSpLGDNCWWhd6lOxFbdbH13tg1UWU2vDeFfFuYfJPK5LMqAHb6rGbK+Aq1hnZWA==","signatures":[{"sig":"MEYCIQCKuX41IWY5LLZgirQT/Q5VsfEtqM5gsRDtDBIkwYekvgIhAKhPbBvBujVuTHwUdQ0vKuU1sezUvFz0TpAQQ98BEULS","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alpaca-open-api%2fmcp@1.0.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":628739},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"4361136098a4827a21e5870df1b4c5cd4596107e","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-open-api.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.16.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.18.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"1.0.2"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.0.2_1783112283360_0.174957344337495","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@alpaca-open-api/mcp","version":"1.1.0","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@1.1.0","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"49c4cc236ec3ae5ae97da0ea9daf792ad403aabd","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.1.0.tgz","fileCount":3,"integrity":"sha512-7/i1SgkoVKoS05xn/WOoYsgxsq1vbMmxX/mkiO9OXPSE0oN/gvmCdL6PRum7EJWwnlUuw55OSLUy25sC9HSGeQ==","signatures":[{"sig":"MEUCIQD4irgkowb4x0+KvvfXHE3wwLxw36eC6Z+LnNsgO6KCaQIgPCOIVPDizPJ5MBEwS72yLJP0SZbjCaI/nzvrN0s9Ges=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alpaca-open-api%2fmcp@1.1.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":619304},"type":"module","engines":{"node":">=18.0.0"},"gitHead":"d81671fce8b26c0a5a08a9dc41e777e1df82ea9e","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-open-api.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.17.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.1.0_1787403201330_0.921382500761825","host":"s3://npm-registry-packages-npm-production"}},"1.2.0":{"name":"@alpaca-open-api/mcp","version":"1.2.0","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@1.2.0","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"cc97c39e2333d6f2815772def6a77826b466e29c","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.2.0.tgz","fileCount":3,"integrity":"sha512-79PKuiT5GGz04eJXiTrCECy9vtld+am82kKmCSb3sgQlHre0mJPk5/LEd0n3zNV47r52uzSKmL6bbR4wM4wxwQ==","signatures":[{"sig":"MEYCIQCGF9sr/DZhUexBMfYZzL1ZinadpSvt6UKVT/Lx6DEsHwIhAPeV6Vsiwh/liixef9arQTtyeT9u01dUbPIID8wwQBCg","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alpaca-open-api%2fmcp@1.2.0","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":626444},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"728c5875cf453428dff67da1a2da9fcf24eab2c5","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-open-api.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.17.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.0_1787418157861_0.42822505770852404","host":"s3://npm-registry-packages-npm-production"}},"1.2.1":{"name":"@alpaca-open-api/mcp","version":"1.2.1","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","_id":"@alpaca-open-api/mcp@1.2.1","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"bin":{"alpaca-mcp":"dist/mcp.js"},"dist":{"shasum":"d4dedbfc321d67e236115a4daecee4e18a8c7074","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.2.1.tgz","fileCount":3,"integrity":"sha512-bKFnfjom/3UMxGjnk4ro4AkLPKE5goESKBDOfDkB8gYxlm0YBAT10Wy/g6h5WTRGxmVn2BLYWVKPN4xQ3A7jPA==","signatures":[{"sig":"MEUCIQCLav29WJTbqnKrn9Mbahof5fA9+h1Rb8J9SWJNtZZ62AIgEJtA0OOdBFHmcNOhL7NdOLvvgjhxvjJ0j+z6xYVNv38=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alpaca-open-api%2fmcp@1.2.1","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"unpackedSize":624593},"type":"module","engines":{"node":">=20.0.0"},"gitHead":"88e7f927ea48c5c5b2bd70f2ac0d24a070a7ed37","scripts":{"dev":"bun run --watch src/mcp.ts","build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","prepublishOnly":"npm run build"},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"repository":{"url":"git+https://github.com/yagop/alpaca-open-api.git","type":"git","directory":"packages/mcp"},"_npmVersion":"11.17.0","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","directories":{},"_nodeVersion":"24.19.0","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.30.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"@alpaca-open-api/core":"workspace:*"},"_npmOperationalInternal":{"tmp":"tmp/mcp_1.2.1_1787436473887_0.7075717643845298","host":"s3://npm-registry-packages-npm-production"}},"1.2.2":{"name":"@alpaca-open-api/mcp","version":"1.2.2","description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","type":"module","bin":{"alpaca-mcp":"dist/mcp.js"},"scripts":{"build":"bun build src/mcp.ts --outfile dist/mcp.js --target node --conditions source --external @modelcontextprotocol/sdk --external zod","start":"bun run src/mcp.ts","dev":"bun run --watch src/mcp.ts","prepublishOnly":"npm run build"},"keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"author":{"name":"Yago"},"license":"MIT","repository":{"type":"git","url":"git+https://github.com/yagop/alpaca-open-api.git","directory":"packages/mcp"},"homepage":"https://github.com/yagop/alpaca-open-api#readme","bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","zod":"^4.4.3"},"devDependencies":{"@alpaca-open-api/core":"workspace:*"},"engines":{"node":">=20.0.0"},"gitHead":"e77592074afacdeb0b2be3c48351215973c3cea6","_id":"@alpaca-open-api/mcp@1.2.2","_nodeVersion":"24.19.0","_npmVersion":"11.17.0","dist":{"integrity":"sha512-lRhqiihJKX8LpJtuFibFHSoWkg14njKHbFrMhleEp8V/eXL2f7nGJCYYK8nXKRoeo1tax36FmYZVf5Fd3VfZ0g==","shasum":"82ba8f0b592b33700296f2401cd20b8a7247f5ac","tarball":"https://registry.npmjs.org/@alpaca-open-api/mcp/-/mcp-1.2.2.tgz","fileCount":3,"unpackedSize":636449,"attestations":{"url":"https://registry.npmjs.org/-/npm/v1/attestations/@alpaca-open-api%2fmcp@1.2.2","provenance":{"predicateType":"https://slsa.dev/provenance/v1"}},"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCAEBRgWQULT5+nG18EQBWiOgFcZxRDhIVy4ceXMQ4XqwIhAKfnOHX9ejNGOH2HeVFU9TedqwkIuFIzCbE4wj2M+p6R"}]},"_npmUser":{"name":"yagop","email":"yagoperezs@gmail.com"},"directories":{},"maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_1.2.2_1787492288842_0.5737738433904147"},"_hasShrinkwrap":false}},"time":{"created":"2026-06-20T10:35:44.080Z","modified":"2026-08-23T13:38:09.291Z","0.1.0-rc.0":"2026-06-20T10:35:44.386Z","1.0.0":"2026-06-20T14:32:19.808Z","1.0.1":"2026-06-20T15:13:53.807Z","1.0.2":"2026-07-03T20:58:03.495Z","1.1.0":"2026-08-22T12:53:21.518Z","1.2.0":"2026-08-22T17:02:38.131Z","1.2.1":"2026-08-22T22:07:54.017Z","1.2.2":"2026-08-23T13:38:08.978Z"},"bugs":{"url":"https://github.com/yagop/alpaca-open-api/issues"},"author":{"name":"Yago"},"license":"MIT","homepage":"https://github.com/yagop/alpaca-open-api#readme","keywords":["alpaca","alpaca-markets","trading","mcp","model-context-protocol","ai","agent"],"repository":{"type":"git","url":"git+https://github.com/yagop/alpaca-open-api.git","directory":"packages/mcp"},"description":"Model Context Protocol (MCP) server for the Alpaca Markets API — exposes all Trading, Market Data, Broker, and AuthX endpoints to AI agents","maintainers":[{"name":"yagop","email":"yagoperezs@gmail.com"}],"readme":"<h1 align=\"center\">🦙 @alpaca-open-api/mcp</h1>\n\n<p align=\"center\">A <a href=\"https://modelcontextprotocol.io/\">Model Context Protocol</a> server that exposes the entire <a href=\"https://alpaca.markets/\">Alpaca Markets</a> API to AI agents — every endpoint as an <code>alpaca_&lt;operationId&gt;</code> tool.</p>\n\n<p align=\"center\">\n<a href=\"https://www.npmjs.com/package/@alpaca-open-api/mcp\"><img src=\"https://img.shields.io/npm/v/@alpaca-open-api/mcp?logo=npm&color=CB3837\" alt=\"npm\"></a>\n<a href=\"https://modelcontextprotocol.io/\"><img src=\"https://img.shields.io/badge/MCP-ready-6E56CF\" alt=\"MCP ready\"></a>\n<img src=\"https://img.shields.io/badge/tools-256-22C55E\" alt=\"tools\">\n<a href=\"https://github.com/yagop/alpaca-open-api/blob/main/LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue\" alt=\"license: MIT\"></a>\n</p>\n\n- 🤖 Every Alpaca endpoint as an `alpaca_<operationId>` MCP tool, via one `npx`.\n- 🛰️ Trading, Market Data, Broker, AuthX — up to **256 tools**.\n- 🔒 Host + auth resolved per API; inputs validated by Zod schemas generated from the OpenAPI specs.\n\n## Install\n\nRun with no install, straight over stdio:\n\n```bash\nnpx -y @alpaca-open-api/mcp\n```\n\n### Add it to your AI agent\n\n**Claude Code**\n\n```bash\nclaude mcp add alpaca \\\n  --env ALPACA_API_KEY=your_paper_key \\\n  --env ALPACA_API_SECRET=your_paper_secret \\\n  --env ALPACA_ENV=paper \\\n  -- npx -y @alpaca-open-api/mcp\n```\n\n**Claude Desktop / Cursor / any MCP client** — add to your MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"alpaca\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@alpaca-open-api/mcp\"],\n      \"env\": {\n        \"ALPACA_API_KEY\": \"your_paper_key\",\n        \"ALPACA_API_SECRET\": \"your_paper_secret\",\n        \"ALPACA_ENV\": \"paper\"\n      }\n    }\n  }\n}\n```\n\n### Run over HTTP\n\nBy default the server speaks **stdio**. Pass `--http` to serve the MCP\n[Streamable HTTP](https://modelcontextprotocol.io/specification/basic/transports)\ntransport instead — useful for remote or multi-client setups:\n\n```bash\nnpx -y @alpaca-open-api/mcp --http --port 3000\n```\n\nThe MCP endpoint is served at `http://<host>:<port>/mcp`; each client gets its\nown session (via the `mcp-session-id` header). Point an HTTP-capable MCP client\nat that URL. The server binds `127.0.0.1` by default.\n\n#### Authentication\n\nThe HTTP endpoint fronts your Alpaca keys, so protect it before exposing it.\nSet `SERVER_HTTP_TOKEN` (or `--token`) to require a bearer token on every\nrequest:\n\n```bash\nSERVER_HTTP_TOKEN=$(openssl rand -hex 32) \\\n  npx -y @alpaca-open-api/mcp --http --host 0.0.0.0 --port 3000\n```\n\nClients must then send `Authorization: Bearer <token>`; anything else gets `401`.\nAs a safety net, the server **refuses to bind a non-loopback host** (anything but\n`127.0.0.1`/`::1`/`localhost`) unless a token is set — so you can't accidentally\npublish an unauthenticated, keys-bearing endpoint.\n\n```bash\nclaude mcp add --transport http alpaca http://your-host:3000/mcp \\\n  --header \"Authorization: Bearer $SERVER_HTTP_TOKEN\"\n```\n\n## Configuration\n\n| Variable | Required | Default | Purpose |\n| --- | :---: | --- | --- |\n| `ALPACA_API_KEY` | ✅ | — | API key (live and paper keys are different) |\n| `ALPACA_API_SECRET` | ✅ | — | API secret |\n| `ALPACA_ENV` | | `live` | `paper` or `live` |\n| `ALPACA_TOOLSETS` | | `trading,data` | Comma-separated subset to expose: `trading,data,broker,authx` (all four = ~256 tools) |\n| `SERVER_HTTP` | | — | `1`/`true` to serve over HTTP instead of stdio (same as `--http`) |\n| `SERVER_PORT` | | `3000` | HTTP port (with `--http`) |\n| `SERVER_HOST` | | `127.0.0.1` | HTTP bind address (with `--http`) |\n| `SERVER_HTTP_TOKEN` | | — | Bearer token required on every HTTP request; **mandatory** to bind a non-loopback host |\n\n> ⚠️ The server **defaults to `live`** and allows order placement in the default `trading` toolset. Use `ALPACA_ENV=paper` with your paper keys while you experiment. Live and paper API keys differ.\n\n## Documentation\n\nFull docs, the typed library client ([`@alpaca-open-api/core`](https://www.npmjs.com/package/@alpaca-open-api/core)), and source:\n**https://github.com/yagop/alpaca-open-api**\n\n## Disclaimer\n\nUnofficial and **not affiliated with, endorsed by, or sponsored by Alpaca**. Provided \"as is\", without warranty of any kind. Nothing here is financial, investment, or trading advice. Trading involves substantial risk of loss — always test with paper trading (`ALPACA_ENV=paper`) first.\n\n## License\n\n[MIT](https://github.com/yagop/alpaca-open-api/blob/main/LICENSE)\n","readmeFilename":"README.md"}