alloc-context 0.1.0__py3-none-any.whl

alloc_context-0.1.0.dist-info/METADATA

@@ -0,0 +1,154 @@
+Metadata-Version: 2.4
+Name: alloc-context
+Version: 0.1.0
+Summary: AllocContext — BTC/ETH allocation context, drift, and rebalance facts
+License: MIT
+Project-URL: Homepage, https://github.com/negillett/alloc-context
+Project-URL: Documentation, https://github.com/negillett/alloc-context/blob/main/docs/agent-integration.md
+Project-URL: Repository, https://github.com/negillett/alloc-context
+Project-URL: Issues, https://github.com/negillett/alloc-context/issues
+Project-URL: Changelog, https://github.com/negillett/alloc-context/releases
+Project-URL: MCP Server, https://mcp.alloc-context.com/mcp
+Keywords: mcp,x402,bitcoin,ethereum,portfolio,allocation,agents,crypto,rebalance
+Classifier: Development Status :: 4 - Beta
+Classifier: Intended Audience :: Developers
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Topic :: Office/Business :: Financial
+Classifier: Topic :: Software Development :: Libraries :: Python Modules
+Requires-Python: >=3.11
+Description-Content-Type: text/markdown
+License-File: LICENSE
+Requires-Dist: pyyaml>=6.0
+Requires-Dist: requests>=2.31
+Requires-Dist: PyJWT>=2.8
+Requires-Dist: cryptography>=42.0
+Provides-Extra: mcp
+Requires-Dist: mcp>=1.6; extra == "mcp"
+Provides-Extra: hosted
+Requires-Dist: mcp>=1.6; extra == "hosted"
+Requires-Dist: x402[evm,fastapi]>=2.0; extra == "hosted"
+Requires-Dist: cdp-sdk>=1.46; extra == "hosted"
+Requires-Dist: uvicorn[standard]>=0.30; extra == "hosted"
+Provides-Extra: dev
+Requires-Dist: pytest>=8.0; extra == "dev"
+Requires-Dist: mcp>=1.6; extra == "dev"
+Requires-Dist: x402[evm,fastapi]>=2.0; extra == "dev"
+Requires-Dist: cdp-sdk>=1.46; extra == "dev"
+Requires-Dist: uvicorn[standard]>=0.30; extra == "dev"
+Dynamic: license-file
+
+# AllocContext
+
+**Allocation context for BTC/ETH** — drift, band checks, USD rebalance moves,
+and a fused market backdrop (Fear & Greed, Kalshi, ETF flows, macro) as
+deterministic JSON over MCP.
+
+The product is an **agent-native MCP API** with x402 pay-per-call on Base —
+see [docs/mcp.md](docs/mcp.md).
+
+## Hosted MCP (production)
+
+Try the public endpoint without self-hosting:
+
+| | |
+|--|--|
+| **URL** | `https://mcp.alloc-context.com/mcp` |
+| **Discovery** | [llms.txt](https://mcp.alloc-context.com/llms.txt), [x402 manifest](https://mcp.alloc-context.com/.well-known/x402.json) |
+| **Pricing** | **$0.02** cached context/math · **$0.05** live ingest or portfolio |
+| **Payment** | x402 on Base — USDC or EURC |
+
+Agents find the service via [CDP Bazaar](docs/mcp-discovery.md). Integration
+guide: [docs/agent-integration.md](docs/agent-integration.md). Example JSON:
+[docs/examples.md](docs/examples.md).
+
+**Try free locally** (no payment): `./scripts/dev-up.sh` — see
+[docs/local-dev.md](docs/local-dev.md).
+
+Optional live portfolio reads use read-only exchange credentials passed in
+each request. Not financial advice.
+
+```text
+ingest → store → rollup → MCP tools (+ optional x402 HTTP)
+```
+
+This package is **facts and MCP only** — ingest, rollups, and agent tools.
+Email, LLM synthesis, and alert delivery are out of scope for this repository.
+
+## Try it locally
+
+```bash
+git clone git@github.com:negillett/alloc-context.git
+cd alloc-context
+python3.11 -m venv .venv && source .venv/bin/activate
+pip install -e ".[dev]"
+cp .env.example .env          # fill locally; never commit
+cp config/config.example.yaml config/config.yaml
+
+python -m alloccontext ingest --dry-run
+python -m alloccontext rollup --scope daily --stdout
+pytest
+```
+
+**MCP (stdio):** `pip install -e ".[mcp]"` then `alloc-context mcp`.
+See [docs/cursor-mcp.md](docs/cursor-mcp.md).
+
+**Hosted MCP + x402:** `pip install -e ".[hosted]"` then
+`alloc-context mcp --transport http --x402`. See [docs/mcp-http.md](docs/mcp-http.md).
+
+**Local dev stack (internal MCP on :8001):** `./scripts/dev-up.sh`.
+See [docs/local-dev.md](docs/local-dev.md).
+
+CLI entry point: `alloc-context` (same as `python -m alloccontext`).
+
+## Commands
+
+| Command | Purpose |
+|---------|---------|
+| `python -m alloccontext ingest` | Pull configured sources → SQLite |
+| `python -m alloccontext rollup --scope daily --stdout` | ContextBundle JSON (facts) |
+| `python -m alloccontext status` | Per-source ingest ages, snapshots, MCP `/health` |
+| `alloc-context mcp` | MCP server (stdio or HTTP) |
+
+## MCP tools
+
+| Tool | Purpose |
+|------|---------|
+| `get_context_bundle` | Full ContextBundle — portfolio, market, sentiment, macro, delta, regime |
+| `get_market_context` | Sentiment, macro, ETF, breadth, and market fields (no portfolio) |
+| `get_context_at` | Saved snapshot from ingest history at a given `as_of` |
+| `get_context_delta` | Notable shifts between two saved snapshots |
+| `get_rebalance_plan` | USD rebalance moves from allocation, target, and NAV |
+| `check_allocation_band` | Drift vs target and whether allocation is outside the band |
+| `check_allocation_bands` | Batch band checks for multiple target scenarios |
+| `get_portfolio_state` | Live NAV and allocation from Kraken or Coinbase (credentials in request) |
+
+See [docs/mcp.md](docs/mcp.md) for arguments, pricing, and resources.
+
+## Documentation
+
+| Document | Purpose |
+|----------|---------|
+| [docs/mcp.md](docs/mcp.md) | MCP tools and x402 |
+| [docs/mcp-http.md](docs/mcp-http.md) | HTTP MCP + x402 setup |
+| [docs/mcp-discovery.md](docs/mcp-discovery.md) | Bazaar and agent discovery |
+| [docs/distribution.md](docs/distribution.md) | GitHub, PyPI, MCP Registry, directories |
+| [docs/agent-integration.md](docs/agent-integration.md) | Paid HTTP MCP + Bazaar for agents |
+| [docs/cursor-mcp.md](docs/cursor-mcp.md) | Cursor stdio MCP |
+| [docs/examples.md](docs/examples.md) | Sample tool JSON (redacted) |
+| [docs/context-bundle.md](docs/context-bundle.md) | ContextBundle schema |
+| [docs/architecture.md](docs/architecture.md) | Pipeline and trust boundaries |
+| [docs/data-sources.md](docs/data-sources.md) | Ingest sources |
+| [docs/self-hosting.md](docs/self-hosting.md) | Optional Linux/systemd ingest + MCP |
+| [docs/local-dev.md](docs/local-dev.md) | Local internal MCP + dev ingest |
+
+## Contributing
+
+GitHub Issues are welcome for bugs, schema feedback, and MCP API suggestions.
+Unsolicited pull requests are not expected — see [CONTRIBUTING.md](CONTRIBUTING.md).
+
+## License
+
+MIT — see [LICENSE](LICENSE).

alloc_context-0.1.0.dist-info/RECORD

@@ -0,0 +1,85 @@
+alloc_context-0.1.0.dist-info/licenses/LICENSE,sha256=GDUcA0IRGCCnLewosUCp6kgW19zdGlnTDlYR4qEps5g,1082
+alloccontext/__init__.py,sha256=GNhoe9BVDD4fVryVcC9AUIlv2vDh7VVkT04RkrQahJk,94
+alloccontext/__main__.py,sha256=pncyOmgB2ICxkLRSTyxh1H8GHEn6bE2pBpJpKlu5U3E,4405
+alloccontext/config.py,sha256=yURf3zzurvqsJ-eIHo0pFOomi0agko3aWhHo_bTp3A0,12918
+alloccontext/horizon.py,sha256=18Y7UlOgF2Lb-lo9O2B9f5Do--TSbLBrFM9oTOrjOyQ,843
+alloccontext/status_report.py,sha256=GOgGboLkVHYb5pmUo8J9EwTArBFP46yJX9KrTNg467w,11145
+alloccontext/timeutil.py,sha256=cgmsWpXGqtxH3r9uM5GLqdzBjYwTkZFmSQz5-1eylVo,227
+alloccontext/x402_production_check.py,sha256=WJXr5hK2gVlbGbjUBrAy0mqol1RX7zBYSRwV36EU2CU,7464
+alloccontext/x402_smoke_redact.py,sha256=a-pAt0VwA1Lz-kq7iapX4ncWK8YQ4nCK4ifajxZnjdY,1138
+alloccontext/ingest/__init__.py,sha256=e6MrP8LbTbU_QkiLBiKfrXr5bgJm_x5tP_bjsoQzvWE,55
+alloccontext/ingest/cf_benchmarks.py,sha256=jtoYVCZvszCc_lA0txPf7bG5oFCr0kr2ulEa9vTYal0,1300
+alloccontext/ingest/cf_history.py,sha256=4lGRVU6uxACH5Xe8P4VfanVTfu5zCKtaU4eOtEhATSg,1994
+alloccontext/ingest/coinbase_client.py,sha256=5Xv0wc8NpAp6fVC8XVbnYGeFq4MJ7g20nyp7Aiigvbs,7466
+alloccontext/ingest/coinbase_portfolio.py,sha256=LZbnGB4qdbS6D4QlmB8dREdh5uZ5veq3nsCTFPyJn2E,1701
+alloccontext/ingest/coingecko.py,sha256=5oEoALSUqFwdkR6ga91avnLJV4BHvrG-FIibvYCrI4s,5665
+alloccontext/ingest/coinmarketcap.py,sha256=TLy7fVIoqajGenzKepjIesvrvEJnTDCaSoeN4gEAf0s,4800
+alloccontext/ingest/env_keys.py,sha256=nTFNt1P6pxXFns9B05OxcgA4WoVS1H3QgO_o-AqQ6RI,287
+alloccontext/ingest/etf_flows.py,sha256=lGSNeURbTysqpwECHr6qtJvWVQR2IYYNPjmRHPNhs2U,9302
+alloccontext/ingest/exchange_http.py,sha256=JMNSv3o9P-Dyn2rjCoO-2oGfnadse4HPYtGTB_XK2fU,898
+alloccontext/ingest/fear_greed.py,sha256=Awp4aKv4IZmnskJ31JFmPeuwtMtBM7axtt5NmTPBl84,2818
+alloccontext/ingest/fred.py,sha256=5zSQtbikW2CmGUmNvQjbiIPKxDTBo_zDFFBKES63yBg,4253
+alloccontext/ingest/http_errors.py,sha256=7dyLHAdJqNr71-bFpu2XGEMv61IJpw81dRy97zrCwTs,826
+alloccontext/ingest/kalshi.py,sha256=ZhMD41h8YyRFdjWV3KYWaQTBpQoDkruHwNbFX2xSZR0,2747
+alloccontext/ingest/kalshi_api.py,sha256=HiacWhuZYI2jv72XNHBjsv19kWOQKkBXxCI-uhxH-nE,6825
+alloccontext/ingest/kalshi_client.py,sha256=A8D7XbN9tkVPadfRn9stnErDIHE9iR9jx6uVh7TSpLs,3277
+alloccontext/ingest/kalshi_files.py,sha256=ZUB9YINJlqjbRNdLC1RJ2l7bGlNML91cACMmghzEdMM,1408
+alloccontext/ingest/kalshi_state.py,sha256=9hAhAS0PN_DXBNcpRVkkdoo8S_VBQszdzYJ_FDAgpEA,2289
+alloccontext/ingest/kraken_client.py,sha256=BBDOj_tXDN0O3b-6gwa_9GlRqD0EbaI6tCn7QbGU8kk,5797
+alloccontext/ingest/kraken_portfolio.py,sha256=d6QYa38Coo_wcIyN697_Jb2shV45T266lz1mKz51IVc,4714
+alloccontext/ingest/macro_calendar.py,sha256=kacNt3YoHCl7anJNSHl_XJb5QetJALLiXf8qNVWt4rk,10640
+alloccontext/ingest/macro_normalize.py,sha256=BOi0eUaVKkhecycg9kDrJlCLGlX-umB7xpDIETwjCWs,2729
+alloccontext/ingest/market_snapshots.py,sha256=N1sv2XYixxHGTjU3da7RozCJFgYZPbdT5Pmcz0HtKo8,3863
+alloccontext/ingest/outcome.py,sha256=o-lDVOSU03jNqeuvyaRedZxIrMBaygVugKD3gwRCbO0,3272
+alloccontext/ingest/parse_helpers.py,sha256=6wxFIp4hU8Ng8SqfeKgHefsLKipjGlAqkfbQPbSEHpc,473
+alloccontext/ingest/runner.py,sha256=cqo0c7aRKi0xdbuTsvQlswEXwKLTZ22WFBSEvLbMEtM,4774
+alloccontext/ingest/exchange/__init__.py,sha256=f3_n44hkOIq_T00c7yBOV334bL1CRBOXC4OCzcO5u2c,171
+alloccontext/ingest/exchange/coinbase_adapter.py,sha256=9hsU3KSAbf9ZW5FWK7Rj1IFRJCyzbRd8TIo5KaKGq9g,2113
+alloccontext/ingest/exchange/kraken_adapter.py,sha256=1f5EdW8A7CJe5X12PLB1LjIy9O94QsxuHBI_Rm9kg-M,2097
+alloccontext/ingest/exchange/live.py,sha256=VMJ7msLxl8i2s3miFTQKT0TubhrDlA41pjno8tPsnjk,3025
+alloccontext/ingest/exchange/portfolio.py,sha256=isYUGnwzk_az0J_LWK0LF1IZ0LNYRS_ky4LTluXXa7w,298
+alloccontext/ingest/exchange/registry.py,sha256=giFgD5WdLeMPAhJUMLVlB64yeBI-oVCPM3219YfQV08,841
+alloccontext/ingest/exchange/types.py,sha256=-TriA4kRdMfoILBHQHrwkzQ-WcQAJFsEiLYFXUn54mk,107
+alloccontext/mcp/__init__.py,sha256=wv7woItWFRtf59FRFnqIEbN7k1K3vDwyywbMXSAK_9Q,39
+alloccontext/mcp/assets.py,sha256=5A6PI-0KlADBoZxApSQmpwTfeF5MYCU2ETdpmtFS6l4,4880
+alloccontext/mcp/bazaar.py,sha256=jS1OXfp5-zVP7bCvsnQznvAFqdmDfextj2LbBPeXf2I,22157
+alloccontext/mcp/contracts.py,sha256=jMLENAkeXp30-giy82Zgca8Q1-FNKSHemTPnIO6fcI0,7426
+alloccontext/mcp/handlers.py,sha256=A0NJ-m6N_8woDSYuWds-yvzTtZiE-Tc7maJatbfM3oQ,15187
+alloccontext/mcp/http.py,sha256=z00tGJh6bUmlEgWtmkYksFlaFnFuqhYCju69wQc3qy0,7625
+alloccontext/mcp/payment_middleware.py,sha256=z5T_tAFSqFddeV1xyizf6q-0KaOdacUWBIaKIEyCKVs,7650
+alloccontext/mcp/server.py,sha256=AJypRnnDjt0cJr2el82M0b3evWCp2fnDyrmZzYv7KuA,10413
+alloccontext/mcp/staleness.py,sha256=bw92FLStzIdWGE03ymIPzrjGCbWG39XKcr9qpI6qLUY,873
+alloccontext/mcp/validation.py,sha256=oyjr6ePHyjYPhGi7HNlJahS2gogEFKKhQ7Ins7L5FRk,1759
+alloccontext/mcp/x402_bazaar_dynamic.py,sha256=_hmYgE7zv9xtbtjzmcjk66eXBnfAESDDey8rPsjoEas,3669
+alloccontext/mcp/x402_config.py,sha256=2n87QnDpo5AJTbE1yZVEOO840M38tY3GDudd0JdeYGI,4675
+alloccontext/mcp/x402_pricing.py,sha256=lkesZBU87rW9Xy80qQBfehTue6Cutzw_92jlpJvbdes,1609
+alloccontext/mcp/x402_stables.py,sha256=PCA5UiZYwI5wUvYGR2sfoyBT8OyjTS6ViK5WOXUNwGY,5196
+alloccontext/rollup/__init__.py,sha256=myPg_8-snQKvaowD1GmhJlqBOJNXwOy6_dnQEBdv00o,44
+alloccontext/rollup/band.py,sha256=51sCxv0YNU40EsXLBSntxc7-mZw5_lxZk1BZXNORt_w,1534
+alloccontext/rollup/breadth.py,sha256=15YWVxb3GQ5SpGfvDS00HuIFeLyMaJCSZ_qxO6XQkqI,1669
+alloccontext/rollup/cf_math.py,sha256=4SlfqvMFiqPoRuN5buDE30uoExnI7Nc4Ntc4AaPlVww,2743
+alloccontext/rollup/cluster.py,sha256=3v6UlJ5wjbhVXoZtUQGWlxbsaHH59KJtKJU4zD1uPgg,4785
+alloccontext/rollup/cluster_config.py,sha256=Y5x4ulY7IoX1TWUo9QCH_dXtgsV4wY3Hxjo6zS4kQ4c,2943
+alloccontext/rollup/comparison.py,sha256=2RGwBjVipO0itYT-j8-H7DgAsoEY9CFHccbKAHw2yt8,2569
+alloccontext/rollup/context.py,sha256=TZNV2TXZmio0pX9vAlmxiM5u4LKtPpWV5NDbrVEV7Os,3395
+alloccontext/rollup/delta.py,sha256=3phVngnbv-hCvF8gXEIBA-8sBXjf4wuH3IjiRRpqW9I,4033
+alloccontext/rollup/etf.py,sha256=xt1qLBlveGSkh5TRTOtN4pEu_2kLeBwZA0iB-IkwQ_s,3508
+alloccontext/rollup/fear_greed.py,sha256=T3-nEOFwqPKCu_RSQ2RHy3xrGgXrB8FRMSpBUPX9SCc,1652
+alloccontext/rollup/macro.py,sha256=jurjxvOhLANHErSytKkwWn4SVLqVSde5sUDtCgMfRxM,5663
+alloccontext/rollup/portfolio.py,sha256=r5ObchOBoXKEp5tKnjvjJe2qF9NGkoS2Sz6onqESlUo,4597
+alloccontext/rollup/rebalance.py,sha256=cTHS07xmEPojdiIo6cQldPmXpJBrxetJ4E9mlWqeXCw,4552
+alloccontext/rollup/regime.py,sha256=yz0ZIJHTVEzHKNe8TvBg8ZAgfDScwV56WJ7j5-0SjF8,6498
+alloccontext/rollup/sentiment.py,sha256=q2FR9GNYzTutRLfUgJGT2qXCN5grt3l3Vt2C0j6YHAs,3424
+alloccontext/rollup/snapshots.py,sha256=-l-3uTcTOae3zc9MjeTtMI-syPv7ZWThhX1Z_iIA-1o,1642
+alloccontext/rollup/tape.py,sha256=5CNtNxcjVUdzJJWFXKjYQEKLx6p60EMQvPzTskdYwrY,5429
+alloccontext/store/__init__.py,sha256=47DEQpj8HBSa-_TImW-5JCeuQeRkm5NMpJWZG3hSuFU,0
+alloccontext/store/db.py,sha256=yFbBjjHPV_89-9M-xxFr8DC6qg18AR7ApLz5W3JGUIU,5493
+alloccontext/store/jsonutil.py,sha256=mxKKUQw30FVJYaWJUVqIm_Q8IhOHyHjIsjsLaqDLW_8,237
+alloccontext/store/meta.py,sha256=SB_CPQzwklXhTEwpK4QPaCEhwja0YXwXTlnmf6MBOrs,529
+alloccontext/store/retention.py,sha256=SkE1CI9jcRJJ-QmTDr5EHSu7xnz5YGEznwgp9aTwwGk,2132
+alloccontext/store/status.py,sha256=-_8DlA_yImP46kbpPiywqxwyix9MSwfuFq4oAAlA80I,2648
+alloc_context-0.1.0.dist-info/METADATA,sha256=NB9ckjLNJ_I80OZWi6F-kCxF5d0mV5Z85KcD0r_E5iE,6433
+alloc_context-0.1.0.dist-info/WHEEL,sha256=aeYiig01lYGDzBgS8HxWXOg3uV61G9ijOsup-k9o1sk,91
+alloc_context-0.1.0.dist-info/entry_points.txt,sha256=dqR7Juqext6cuAv-7hOS44a3GRVTDqy7On0MoogD3t0,162
+alloc_context-0.1.0.dist-info/top_level.txt,sha256=2XxC-sPSACrglRtVaUGfT7EHZsw1E1dmBMw3uc5yWTE,13
+alloc_context-0.1.0.dist-info/RECORD,,

alloc_context-0.1.0.dist-info/WHEEL

@@ -0,0 +1,5 @@
+Wheel-Version: 1.0
+Generator: setuptools (82.0.1)
+Root-Is-Purelib: true
+Tag: py3-none-any
+

alloc_context-0.1.0.dist-info/entry_points.txt

@@ -0,0 +1,4 @@
+[console_scripts]
+alloc-context = alloccontext.__main__:main
+alloc-context-mcp = alloccontext.mcp.server:main
+alloc-context-mcp-http = alloccontext.mcp.http:main

alloc_context-0.1.0.dist-info/licenses/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 AllocContext contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

alloc_context-0.1.0.dist-info/top_level.txt

@@ -0,0 +1 @@
+alloccontext

alloccontext/__init__.py

@@ -0,0 +1,3 @@
+"""AllocContext — BTC/ETH allocation context and rebalance facts."""
+
+__version__ = "0.1.0"

alloccontext/__main__.py

@@ -0,0 +1,149 @@
+from __future__ import annotations
+
+import argparse
+import json
+import sys
+
+from alloccontext.config import load_config
+from alloccontext.ingest.runner import run_ingest
+from alloccontext.rollup.context import build_context_bundle
+from alloccontext.status_report import (
+    build_status_report,
+    default_mcp_health_url,
+    format_status_report,
+)
+from alloccontext.store.db import connect
+
+
+def cmd_ingest(args: argparse.Namespace) -> int:
+    config = load_config(args.config)
+    conn = connect(config.paths.db)
+    result = run_ingest(conn, config, dry_run=args.dry_run)
+    conn.close()
+    print(json.dumps(result, indent=2))
+    return 0 if result["ok"] else 1
+
+
+def cmd_rollup(args: argparse.Namespace) -> int:
+    config = load_config(args.config)
+    conn = connect(config.paths.db)
+    bundle = build_context_bundle(
+        conn,
+        config,
+        scope=args.scope,
+        rollup=config.rollup,
+        save_snapshot=args.save,
+    )
+    conn.close()
+    if args.stdout:
+        print(json.dumps(bundle, indent=2))
+    else:
+        print(json.dumps({"ok": True, "bundle_id": bundle["bundle_id"]}, indent=2))
+    return 0
+
+
+def cmd_status(args: argparse.Namespace) -> int:
+    config = load_config(args.config)
+    conn = connect(config.paths.db)
+    try:
+        report = build_status_report(
+            config,
+            conn,
+            probe_mcp=not args.no_mcp,
+            mcp_health_url=args.mcp_url,
+            mcp_timeout_seconds=args.mcp_timeout,
+        )
+    finally:
+        conn.close()
+    if args.json:
+        print(json.dumps(report, indent=2))
+    else:
+        print(format_status_report(report))
+    return 0 if report.get("ok") else 1
+
+
+def cmd_mcp(args: argparse.Namespace) -> int:
+    if args.transport == "http":
+        from alloccontext.mcp.http import run_http
+
+        run_http(
+            config_path=args.config,
+            host=args.host,
+            port=args.port,
+            x402=args.x402,
+        )
+    else:
+        from alloccontext.mcp.server import run_stdio
+
+        run_stdio(config_path=args.config)
+    return 0
+
+
+def main(argv: list[str] | None = None) -> int:
+    parser = argparse.ArgumentParser(prog="alloc-context")
+    parser.add_argument("--config", default=None, help="Path to config YAML")
+    sub = parser.add_subparsers(dest="command", required=True)
+
+    ingest_p = sub.add_parser("ingest", help="Pull configured data sources")
+    ingest_p.add_argument("--dry-run", action="store_true")
+    ingest_p.set_defaults(func=cmd_ingest)
+
+    rollup_p = sub.add_parser("rollup", help="Build ContextBundle JSON")
+    rollup_p.add_argument("--scope", choices=["daily", "weekly"], default="daily")
+    rollup_p.add_argument("--stdout", action="store_true")
+    rollup_p.add_argument(
+        "--save",
+        action="store_true",
+        help="Persist snapshot for delta chain (normally done by ingest)",
+    )
+    rollup_p.set_defaults(func=cmd_rollup)
+
+    status_p = sub.add_parser(
+        "status",
+        help="Ingest ages, snapshot freshness, optional MCP /health probe",
+    )
+    status_p.add_argument(
+        "--json",
+        action="store_true",
+        help="Machine-readable JSON (default: human text for SSH)",
+    )
+    status_p.add_argument(
+        "--no-mcp",
+        action="store_true",
+        help="Skip HTTP GET to MCP /health",
+    )
+    status_p.add_argument(
+        "--mcp-url",
+        default=None,
+        help=f"MCP health URL (default: {default_mcp_health_url()})",
+    )
+    status_p.add_argument(
+        "--mcp-timeout",
+        type=float,
+        default=5.0,
+        help="Seconds to wait for MCP /health",
+    )
+    status_p.set_defaults(func=cmd_status)
+
+    mcp_p = sub.add_parser("mcp", help="Run MCP server (stdio or HTTP)")
+    mcp_p.add_argument(
+        "--transport",
+        choices=["stdio", "http"],
+        default="stdio",
+        help="stdio for Cursor; http for streamable MCP + optional x402",
+    )
+    mcp_p.add_argument("--host", default="127.0.0.1", help="HTTP bind host")
+    mcp_p.add_argument("--port", type=int, default=8000, help="HTTP bind port")
+    mcp_p.add_argument(
+        "--x402",
+        action="store_true",
+        help="Require x402 USDC payment on HTTP (needs X402_PAY_TO)",
+    )
+    mcp_p.set_defaults(func=cmd_mcp)
+
+    args = parser.parse_args(argv)
+    return int(args.func(args))
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())