{"_id":"@alphacast/mcp","_rev":"5-463e876887d6b5b8a79577fba6e4c3ca","name":"@alphacast/mcp","dist-tags":{"latest":"0.3.0"},"versions":{"0.2.3":{"name":"@alphacast/mcp","version":"0.2.3","keywords":["alphacast","mcp","model-context-protocol","economic-data","data-pipelines"],"license":"MIT","_id":"@alphacast/mcp@0.2.3","maintainers":[{"name":"masaez","email":"miguel.angel.saez@gmail.com"}],"homepage":"https://github.com/alphacast-io/alphacast-mcp#readme","bugs":{"url":"https://github.com/alphacast-io/alphacast-mcp/issues"},"bin":{"alphacast-mcp":"build/index.js"},"dist":{"shasum":"0d2e1e9bf05fa038941d4b1d39a87eb42f9bcbdd","tarball":"https://registry.npmjs.org/@alphacast/mcp/-/mcp-0.2.3.tgz","fileCount":3,"integrity":"sha512-p63TA2AjXWJs6BSk74H3NvsZOSrMOLCXMRJPJKkZfOfVBd+BRz0U36Zyf5fTgO4u3Nc6r3gLeVU9rvm/FQuU6Q==","signatures":[{"sig":"MEYCIQC//khWYbWS+49R0m6lHvK1K5r/sc0l515eATjUiPJKbwIhAKdTbrH6dsDcYTL7TkCszxfDR+AuN6aquTd6v3q+Usx8","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":822931},"main":"build/index.js","engines":{"node":">=18"},"gitHead":"fae1a8a5ec9b2be99cc2198fbeba088713c0409d","scripts":{"dev":"bun --watch src/index.ts","test":"bun test","build":"bun build src/index.ts --outfile build/index.js --target node","start":"bun src/index.ts","compile":"bun build src/index.ts --compile --outfile dist/alphacast-mcp","prepack":"bun run build","pack:dry-run":"npm pack --dry-run","compile:linux":"bun build src/index.ts --compile --target=bun-linux-x64 --outfile dist/alphacast-mcp-linux","compile:mac-arm":"bun build src/index.ts --compile --target=bun-darwin-arm64 --outfile dist/alphacast-mcp-mac-arm","compile:mac-x64":"bun build src/index.ts --compile --target=bun-darwin-x64 --outfile dist/alphacast-mcp-mac-x64","compile:windows":"bun build src/index.ts --compile --target=bun-windows-x64 --outfile dist/alphacast-mcp-windows.exe"},"_npmUser":{"name":"masaez","email":"miguel.angel.saez@gmail.com"},"repository":{"url":"git+https://github.com/alphacast-io/alphacast-mcp.git","type":"git"},"_npmVersion":"8.6.0","description":"MCP server for Alphacast - search, explore, and download economic datasets","directories":{},"_nodeVersion":"22.11.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3.24.0","@types/node":"^22.0.0","@alphacast/grapher-core":"^0.1.3","@modelcontextprotocol/sdk":"^1.12.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.3_1779397310874_0.6228357484474307","host":"s3://npm-registry-packages-npm-production"}},"0.2.4":{"name":"@alphacast/mcp","version":"0.2.4","keywords":["alphacast","mcp","model-context-protocol","economic-data","data-pipelines"],"license":"MIT","_id":"@alphacast/mcp@0.2.4","maintainers":[{"name":"masaez","email":"miguel.angel.saez@gmail.com"}],"homepage":"https://github.com/alphacastio/alphacast-mcp#readme","bugs":{"url":"https://github.com/alphacastio/alphacast-mcp/issues"},"bin":{"alphacast-mcp":"bin/alphacast-mcp.js"},"dist":{"shasum":"3552158b34183962745bdcc65b1d6d05a4c595a3","tarball":"https://registry.npmjs.org/@alphacast/mcp/-/mcp-0.2.4.tgz","fileCount":4,"integrity":"sha512-fWKH+1eSIiex+ff+HwronFqjmXPdl+10XLnaEmUykbA37bcSTFw/gRUbBNotTQWOBCq+RDXtlUB8HxSxgJ1sxA==","signatures":[{"sig":"MEQCIC+syyp8Cj/Cafs+9NxTdKk1LGMw2sR1Ui7Oq9OiJrn3AiBpqGVlfb9CVtcg5SzsB3g4oVdvPvi0zM8AbiqVnUGM3g==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":826322},"main":"build/index.js","engines":{"node":">=18"},"gitHead":"290efef1a81e3c2c6002519cbb2be968d6572381","scripts":{"dev":"bun --watch src/index.ts","test":"bun test","build":"bun build src/index.ts --outfile build/index.js --target node","start":"bun src/index.ts","compile":"bun build src/index.ts --compile --outfile dist/alphacast-mcp","prepack":"bun run build","pack:dry-run":"npm pack --dry-run","compile:linux":"bun build src/index.ts --compile --target=bun-linux-x64 --outfile dist/alphacast-mcp-linux","compile:mac-arm":"bun build src/index.ts --compile --target=bun-darwin-arm64 --outfile dist/alphacast-mcp-mac-arm","compile:mac-x64":"bun build src/index.ts --compile --target=bun-darwin-x64 --outfile dist/alphacast-mcp-mac-x64","compile:windows":"bun build src/index.ts --compile --target=bun-windows-x64 --outfile dist/alphacast-mcp-windows.exe"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6b3a20a9-64e0-4672-92eb-c50b4fc7c587"}},"repository":{"url":"git+https://github.com/alphacastio/alphacast-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Alphacast - search, explore, and download economic datasets","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3.24.0","@types/node":"^22.0.0","@alphacast/grapher-core":"^0.1.3","@modelcontextprotocol/sdk":"^1.12.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.4_1779547569341_0.869417451558083","host":"s3://npm-registry-packages-npm-production"}},"0.2.5":{"name":"@alphacast/mcp","version":"0.2.5","keywords":["alphacast","mcp","model-context-protocol","economic-data","data-pipelines"],"license":"MIT","_id":"@alphacast/mcp@0.2.5","maintainers":[{"name":"masaez","email":"miguel.angel.saez@gmail.com"}],"homepage":"https://github.com/alphacastio/alphacast-mcp#readme","bugs":{"url":"https://github.com/alphacastio/alphacast-mcp/issues"},"bin":{"alphacast-mcp":"bin/alphacast-mcp.js"},"dist":{"shasum":"7cf17761ca15f3d15ec1e94ba4253eeb6a7d2962","tarball":"https://registry.npmjs.org/@alphacast/mcp/-/mcp-0.2.5.tgz","fileCount":4,"integrity":"sha512-Wpqa50EnjHYmBQuHzp+cslNQ2gnH4aa7S60WdlTpFQ9lpYBCbebLeIq1augtvsi4rzr0K2kiXKiDf3+e6b5TKg==","signatures":[{"sig":"MEUCIQCX0+OICu5J9g38dUOSeVO6cM4TZeERA/SE32h0njBH2QIgQAu6eRWK6W+ShmDuozfiRz8Upi3CDncFrdKEF0ctljU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":823845},"main":"build/index.js","engines":{"node":">=18"},"gitHead":"50b46078622bb0bfd1fae2bd6eb44442de3a1502","scripts":{"dev":"bun --watch src/index.ts","test":"bun test","build":"bun build src/index.ts --outfile build/index.js --target node --format cjs","start":"bun src/index.ts","prepack":"bun run build","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6b3a20a9-64e0-4672-92eb-c50b4fc7c587"}},"repository":{"url":"git+https://github.com/alphacastio/alphacast-mcp.git","type":"git"},"_npmVersion":"11.12.1","description":"MCP server for Alphacast - search, explore, and download economic datasets","directories":{},"_nodeVersion":"24.15.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3.24.0","@types/node":"^22.0.0","@alphacast/grapher-core":"^0.1.3","@modelcontextprotocol/sdk":"^1.12.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.5_1779813824504_0.7626466256719202","host":"s3://npm-registry-packages-npm-production"}},"0.2.6":{"name":"@alphacast/mcp","version":"0.2.6","keywords":["alphacast","mcp","model-context-protocol","economic-data","data-pipelines"],"license":"MIT","_id":"@alphacast/mcp@0.2.6","maintainers":[{"name":"masaez","email":"miguel.angel.saez@gmail.com"}],"homepage":"https://github.com/alphacastio/alphacast-mcp#readme","bugs":{"url":"https://github.com/alphacastio/alphacast-mcp/issues"},"bin":{"alphacast-mcp":"bin/alphacast-mcp.js"},"dist":{"shasum":"285112b5bdfcb944ab6255bef5f645b5491ecf60","tarball":"https://registry.npmjs.org/@alphacast/mcp/-/mcp-0.2.6.tgz","fileCount":4,"integrity":"sha512-dhJiM5QpWa6ruLexQTgn6ejIL1PbFOAOqXBEdKLjTQNE23yCZneNSN+fQbl1uLwkV30IIXu9paZCXBElmwlY+g==","signatures":[{"sig":"MEUCIFzDMuvcJ7XNXtvyWJEMMrJzGTcqnDr5HRmx1Jk/RdHpAiEAzjkUJNX0u/6WBq9wAMPWaijt33jFG1pPAp7AnUhVPbw=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":823629},"main":"build/index.js","engines":{"node":">=18"},"gitHead":"62cf654ac8b1ea3e7c680e99806557c40e9553f8","scripts":{"dev":"bun --watch src/index.ts","test":"bun test","build":"bun build src/index.ts --outfile build/index.js --target node --format cjs","start":"bun src/index.ts","prepack":"bun run build","pack:dry-run":"npm pack --dry-run"},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6b3a20a9-64e0-4672-92eb-c50b4fc7c587"}},"repository":{"url":"git+https://github.com/alphacastio/alphacast-mcp.git","type":"git"},"_npmVersion":"11.13.0","description":"MCP server for Alphacast - search, explore, and download economic datasets","directories":{},"_nodeVersion":"24.16.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"devDependencies":{"zod":"^3.24.0","@types/node":"^22.0.0","@alphacast/grapher-core":"^0.1.3","@modelcontextprotocol/sdk":"^1.12.1"},"_npmOperationalInternal":{"tmp":"tmp/mcp_0.2.6_1780953594476_0.5025224814387599","host":"s3://npm-registry-packages-npm-production"}},"0.3.0":{"name":"@alphacast/mcp","version":"0.3.0","description":"MCP server for Alphacast - search, explore, and download economic datasets","main":"build/index.js","bin":{"alphacast-mcp":"bin/alphacast-mcp.js"},"publishConfig":{"access":"public"},"scripts":{"build":"bun build src/index.ts --outfile build/index.js --target node --format cjs","prepack":"bun run build","pack:dry-run":"npm pack --dry-run","test":"bun test","dev":"bun --watch src/index.ts","start":"bun src/index.ts"},"license":"MIT","keywords":["alphacast","mcp","model-context-protocol","economic-data","data-pipelines"],"homepage":"https://github.com/alphacastio/alphacast-mcp#readme","repository":{"type":"git","url":"git+https://github.com/alphacastio/alphacast-mcp.git"},"bugs":{"url":"https://github.com/alphacastio/alphacast-mcp/issues"},"engines":{"node":">=18"},"dependencies":{"@alphacast/grapher-core":"^0.1.3","@modelcontextprotocol/sdk":"^1.12.1","jose":"^6.2.2","zod":"^3.24.0"},"devDependencies":{"@types/node":"^22.0.0"},"gitHead":"23e0b952954017d211f01185ed8f93d47288be1a","_id":"@alphacast/mcp@0.3.0","_nodeVersion":"24.18.0","_npmVersion":"11.16.0","dist":{"integrity":"sha512-AllIhLfsxui+gdl00DkZQtYPo4FuwMOgEZKMwomxRPZnmvepgUA4gGzK829EjdiU3C54+GbmdiInt6E9Z1npsQ==","shasum":"c5e048bb328eea671ecc19c72e52caa166db5315","tarball":"https://registry.npmjs.org/@alphacast/mcp/-/mcp-0.3.0.tgz","fileCount":4,"unpackedSize":923837,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIG3baZS8P3RKNTKLKlsa6Ycceq5oRqQDdAMPPcqqQ4e3AiB47UAu7DjdOh8bK7Qn5Zqxb7LRVToNgL1DPjpE11eldA=="}]},"_npmUser":{"name":"GitHub Actions","email":"npm-oidc-no-reply@github.com","trustedPublisher":{"id":"github","oidcConfigId":"oidc:6b3a20a9-64e0-4672-92eb-c50b4fc7c587"}},"directories":{},"maintainers":[{"name":"masaez","email":"miguel.angel.saez@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.3.0_1783956364840_0.7692377612246502"},"_hasShrinkwrap":false}},"time":{"created":"2026-05-21T21:01:50.671Z","modified":"2026-07-13T15:26:05.169Z","0.2.3":"2026-05-21T21:01:51.113Z","0.2.4":"2026-05-23T14:46:09.580Z","0.2.5":"2026-05-26T16:43:44.785Z","0.2.6":"2026-06-08T21:19:54.644Z","0.3.0":"2026-07-13T15:26:05.063Z"},"bugs":{"url":"https://github.com/alphacastio/alphacast-mcp/issues"},"license":"MIT","homepage":"https://github.com/alphacastio/alphacast-mcp#readme","keywords":["alphacast","mcp","model-context-protocol","economic-data","data-pipelines"],"repository":{"type":"git","url":"git+https://github.com/alphacastio/alphacast-mcp.git"},"description":"MCP server for Alphacast - search, explore, and download economic datasets","maintainers":[{"name":"masaez","email":"miguel.angel.saez@gmail.com"}],"readme":"# Alphacast MCP Server\n\nAn [MCP](https://modelcontextprotocol.io/) server that connects AI agents such as Claude, Codex, Cursor, and other MCP clients to the [Alphacast](https://www.alphacast.io) economic data platform.\n\nUse it to search economic datasets, inspect metadata, download data, browse external providers, work with market tickers, and create or run Alphacast pipelines directly from your AI tool.\n\n## Setup\n\n### 1. Get An API Key\n\nCreate an API key in [Alphacast settings](https://www.alphacast.io/settings).\n\n### 2. Configure Your MCP Client\n\nThe recommended setup is to run the npm package with `npx`. This lets your client fetch the latest published server automatically.\n\n**Claude Code** — add this to your project's `.mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"alphacast\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@alphacast/mcp\"],\n      \"env\": {\n        \"ALPHACAST_API_KEY\": \"your-api-key-here\"\n      }\n    }\n  }\n}\n```\n\n**Claude Desktop / Codex Desktop** — use these values in the custom MCP server form:\n\n| Field | Value |\n|-------|-------|\n| Command | `npx` |\n| Arguments | `-y`, `@alphacast/mcp` |\n| Environment variable | `ALPHACAST_API_KEY=your-api-key-here` |\n\n**Claude Code CLI**:\n\n```bash\nclaude mcp add alphacast -e ALPHACAST_API_KEY=your-api-key-here -- npx -y @alphacast/mcp\n```\n\nUse `--scope user` to make the server available across all projects:\n\n```bash\nclaude mcp add --scope user alphacast -e ALPHACAST_API_KEY=your-api-key-here -- npx -y @alphacast/mcp\n```\n\nTo check or remove the server later:\n\n```bash\nclaude mcp list\nclaude mcp remove alphacast\n```\n\nTo pin a specific version:\n\n```json\n[\"-y\", \"@alphacast/mcp@0.3.0\"]\n```\n\nOr with `claude mcp add`:\n\n```bash\nclaude mcp add alphacast -e ALPHACAST_API_KEY=your-api-key-here -- npx -y @alphacast/mcp@0.3.0\n```\n\n## Environment Variables\n\n| Variable | Required | Default | Description |\n|----------|----------|---------|-------------|\n| `ALPHACAST_API_KEY` | Yes | - | Your Alphacast API key |\n| `ALPHACAST_API_HOST` | No | `https://api.alphacast.io` | Alphacast API base URL |\n| `ALPHACAST_WORKSPACE_HOST` | No | `https://www.alphacast.io` | Alphacast workspace base URL |\n| `ALPHACAST_MCP_TRANSPORT` | No | `stdio` | Use `http` to run the remote MCP server |\n| `AUTH0_ISSUER_BASE_URL` | HTTP only | - | Auth0 issuer used to validate MCP bearer tokens |\n| `ALPHACAST_MCP_AUDIENCE` | HTTP only | - | Auth0 API audience for the remote MCP service |\n| `ALPHACAST_MCP_INTERNAL_SECRET` | HTTP only | - | Shared secret used by MCP to resolve Auth0 users in Workspace |\n| `ALPHACAST_MCP_AUTH_CACHE_MS` | No | `30000` | Short-lived cache for resolved remote bearer tokens |\n| `ALPHACAST_MCP_PORT` / `PORT` | HTTP only | `3000` | HTTP server port |\n\nProvider-specific API keys are managed in [Alphacast settings](https://www.alphacast.io/settings), not through MCP tools.\n\n## Tools\n\n### Discover And Fetch Data\n\n| Tool | Description |\n|------|-------------|\n| `search_catalog` | Search the Alphacast catalog for datasets, charts, insights, or repositories |\n| `list_datasets` | List all datasets you have access to |\n| `get_dataset` | Get detailed metadata and schema for a specific dataset |\n| `get_dataset_profile` | Inspect dataset metadata, columns, entities, date stats, row count, and a small sample before downloading |\n| `download_dataset` | Download dataset data as JSON or CSV |\n| `list_providers` | List available external data providers |\n| `get_provider` | Get metadata, parameters, and capabilities for a provider |\n| `browse_provider` | Browse a provider's data catalog hierarchy |\n| `search_provider` | Search for series within a provider |\n| `get_series` | Fetch a specific external-provider series |\n| `search_tickers` | Search public market tickers, ETFs, indexes, and ISINs |\n| `get_ticker` | Get profile/detail metadata for a ticker symbol or ISIN |\n| `get_ticker_data` | Get historical ticker price data for a chosen period |\n| `get_grapher_config_reference` | Get chart-type-specific Grapher config fields and allowed values |\n| `validate_grapher_config` | Validate chart-data or raw Grapher config before creating or editing chart pipeline steps |\n| `get_chart_details` | Get Grapher config and pipeline ownership for a chart URL |\n\n### Repositories\n\n| Tool | Description |\n|------|-------------|\n| `list_repositories` | List your writable repositories |\n| `get_default_repository` | Get your current/default writable repository |\n| `get_repository` | Get metadata for a specific repository |\n\n### Pipelines\n\nBuild, debug, and run data transformation pipelines directly from your agent.\n\n| Tool | Description |\n|------|-------------|\n| `list_pipelines` | List pipelines in a repository; defaults to your current/default writable repository |\n| `get_pipeline` | Inspect pipeline steps, validation errors, and per-step URLs |\n| `create_pipeline` | Create a new pipeline, optionally with initial steps |\n| `list_pipeline_step_types` | List available pipeline step types and groups |\n| `get_pipeline_step_config` | Get configuration fields for a step type |\n| `get_pipeline_formula_reference` | Get Alphacast formula syntax and function reference |\n| `add_pipeline_step` | Add a step such as fetch, transform, chart, or publish |\n| `edit_pipeline_step` | Update a step's configuration |\n| `delete_pipeline_step` | Remove a step from a pipeline |\n| `get_step_preview` | Run the pipeline up to a step and return preview data |\n| `get_step_data` | Fetch cached output data for a step |\n| `get_pipeline_run` | Get a specific run by ID, including status, timestamps, and per-step logs |\n| `wait_pipeline_run` | Wait for a pipeline run to finish and return status/logs |\n\n### Large Results\n\nTools that can return full tabular outputs, such as `download_dataset` and `get_step_data`, are size-aware:\n\n- `outputMode: \"auto\"` returns small results inline and saves large results to a temp file with a preview.\n- `outputMode: \"file\"` always saves the full result to a temp file.\n- `outputMode: \"inline\"` returns bounded inline text and truncates at `maxInlineChars` when needed.\n- `maxInlineChars` defaults to `50000` and is capped at `500000`.\n\n## Run Manually\n\n```bash\nALPHACAST_API_KEY=your-api-key-here npx -y @alphacast/mcp\n```\n\nThe server runs over stdio and is intended to be launched by an MCP client.\n\n## Run As A Remote MCP Service\n\n```bash\nALPHACAST_MCP_TRANSPORT=http \\\nAUTH0_ISSUER_BASE_URL=https://your-tenant.auth0.com \\\nALPHACAST_MCP_AUDIENCE=https://mcp.alphacast.io \\\nALPHACAST_MCP_INTERNAL_SECRET=shared-secret \\\nALPHACAST_WORKSPACE_HOST=https://www.alphacast.io \\\nALPHACAST_API_HOST=https://api.alphacast.io \\\nPORT=3000 \\\nnpm start\n```\n\nRemote mode expects MCP clients to send an Auth0 bearer token whose audience is `ALPHACAST_MCP_AUDIENCE`. The server validates the JWT locally with Auth0 JWKS, asks Workspace to resolve the verified Auth0 user to an account-bound Alphacast API key, and caches that resolution briefly. The inbound Auth0 token is never forwarded to `api.alphacast.io`.\n\nRemote mode also advertises OAuth protected-resource metadata at:\n\n```text\n/.well-known/oauth-protected-resource\n/.well-known/oauth-protected-resource/mcp\n```\n\nUnauthenticated `/mcp` requests include a `WWW-Authenticate` challenge pointing clients to that metadata, which in turn points clients to the configured `AUTH0_ISSUER_BASE_URL`.\n\n### Codex Remote MCP Login\n\nFor local OAuth testing, configure a Native Auth0 application with an allowed callback URL for Codex, for example:\n\n```text\nhttp://localhost:5555/callback\n```\n\nThen add and log in to the remote MCP server:\n\n```bash\ncodex mcp add alphacast \\\n  --url http://localhost:3001/mcp \\\n  --oauth-client-id YOUR_AUTH0_NATIVE_APP_CLIENT_ID \\\n  --oauth-resource http://localhost:3001/mcp\n\ncodex mcp login alphacast \\\n  --scopes openid,profile,email,mcp:read,mcp:write\n```\n\nIf the Auth0 application requires a fixed callback port, set this in Codex config:\n\n```toml\nmcp_oauth_callback_port = 5555\nmcp_oauth_callback_url = \"http://localhost:5555/callback\"\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}