{"_id":"@bucket-foundation/mcp","name":"@bucket-foundation/mcp","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bucket-foundation/mcp","version":"0.1.0","publishConfig":{"access":"public"},"description":"Stdio MCP server for the Bucket Foundation research rail (bucket.foundation). Three tools: bucket_research, bucket_cite, bucket_canon_list.","bin":{"bucket-mcp":"bin/bucket-mcp"},"scripts":{"start":"python3 bucket-mcp.py"},"keywords":["mcp","bucket-foundation","feed402","x402","research","claude"],"author":{"name":"Bucket Foundation"},"license":"MIT","homepage":"https://www.bucket.foundation","repository":{"type":"git","url":"git+https://github.com/bucket-foundation/bucket-mcp.git"},"engines":{"node":">=18"},"_id":"@bucket-foundation/mcp@0.1.0","gitHead":"3f197125d527053fa44e8214df9d2c6a939e7f80","bugs":{"url":"https://github.com/bucket-foundation/bucket-mcp/issues"},"_nodeVersion":"22.21.0","_npmVersion":"10.9.4","dist":{"integrity":"sha512-XI+xwPYGodXNrIqcN18ygcyGCE9uMZqY6nvHABei0KBUf7tRelzJaHa32qKsSp4OigV1QuWC2Z7ms1e34ZKk6w==","shasum":"f4b19000f9959e586d16998e2880e4f53cdb754e","tarball":"https://registry.npmjs.org/@bucket-foundation/mcp/-/mcp-0.1.0.tgz","fileCount":5,"unpackedSize":16238,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQDbMzyudxSeSy418HZC7AWgMFayhElkxQ1pX+y6/7lWvgIgdU2FPCXWdEfctNQDGfQRjYq2GD3qHODrspAF3YROQHk="}]},"_npmUser":{"name":"gdichio","email":"gianyrox@gmail.com"},"directories":{},"maintainers":[{"name":"gdichio","email":"gianyrox@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.1.0_1777031638828_0.701124850251686"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-24T11:53:58.725Z","0.1.0":"2026-04-24T11:53:58.973Z","modified":"2026-04-24T11:53:59.211Z"},"maintainers":[{"name":"gdichio","email":"gianyrox@gmail.com"}],"description":"Stdio MCP server for the Bucket Foundation research rail (bucket.foundation). Three tools: bucket_research, bucket_cite, bucket_canon_list.","homepage":"https://www.bucket.foundation","keywords":["mcp","bucket-foundation","feed402","x402","research","claude"],"repository":{"type":"git","url":"git+https://github.com/bucket-foundation/bucket-mcp.git"},"author":{"name":"Bucket Foundation"},"bugs":{"url":"https://github.com/bucket-foundation/bucket-mcp/issues"},"license":"MIT","readme":"# bucket-mcp\n\nZero-dependency stdio MCP server for the **Bucket Foundation** research rail.\nPlug into Claude Desktop or Claude Code and get three tools:\n\n| Tool | What |\n|------|------|\n| `bucket_research(query, tier?)` | Call `bucket.foundation/api/research` (zero-key proxy over the feed402 rail). Default tier `insight` ($0.002/call). |\n| `bucket_cite(doi_or_url)` | Return a CSL-JSON citation block. Uses doi.org content negotiation for DOIs. |\n| `bucket_canon_list(branch?)` | List canon-tier entries. Seven branches: `mathematics`, `physics`, `chemistry`, `information`, `biophysics`, `cosmology`, `mind`. |\n\nCanon holds only **foundations** — axioms, laws, primary derivations. Outcomes\n(longevity, disease, cognition) are downstream applications, not canon.\n\n## Install (Claude Code / Claude Desktop, user scope)\n\n```bash\n# 1. Clone\ngh repo clone bucket-foundation/bucket-mcp ~/bucket-mcp\n# or: git clone https://github.com/bucket-foundation/bucket-mcp ~/bucket-mcp\n\n# 2. Register at user scope (works in every Claude session on this machine)\nclaude mcp add --scope user --transport stdio bucket -- \\\n  bash -lc \"exec python3 $HOME/bucket-mcp/bucket-mcp.py\"\n\n# 3. Restart Claude Code / Desktop\nclaude mcp list   # should show 'bucket' green\n```\n\nNo `pip install`, no virtualenv, no API key on the MCP user's side. Python 3.8+\nstdlib only.\n\n## Zero-install (planned)\n\n```bash\n# Node (once published):\nnpx bucket-mcp\n\n# Python via uv:\nuvx bucket-mcp\n```\n\nBoth are **pending publish**. Use the git clone path above in the meantime.\n\n## Environment\n\n| Var | Default | Meaning |\n|-----|---------|---------|\n| `BUCKET_BASE_URL` | `https://www.bucket.foundation` | Bucket site base. Override for staging/local. |\n\n## Architecture\n\n```\nClaude agent\n  │\n  ▼ (stdio JSON-RPC 2.0)\nbucket-mcp.py\n  │\n  ▼ (HTTPS)\nbucket.foundation/api/research   ← Track A zero-key proxy\n  │\n  ▼ (x402 + feed402/0.2)\nx402-research.agfarms.dev        ← live reference merchant\n  │\n  ▼\nPubMed / OpenAlex / Semantic Scholar / ClinicalTrials / PubChem / Kruse corpus\n```\n\nThe MCP user pays nothing. The proxy at bucket.foundation holds the funded\nwallet and settles on Base. Agents get cited envelopes; humans get receipts.\n\n## Protocol\n\nMCP over stdio, JSON-RPC 2.0, protocol version `2024-11-05`. All logging on\nstderr; only JSON-RPC messages on stdout. Matches the pattern used by the\nAGFarms in-house [figma-agf](https://github.com/AGFarms/tools) MCP server.\n\n## License\n\nMIT (code). The feed402 spec it speaks is CC0.\n\n## Part of\n\n[Bucket Foundation](https://www.bucket.foundation) — **build the past. build\nhistory. bucket is the new renaissance.** Reference implementation of an open\nprotocol for paid-for-once, citeable-forever primary research.\n","readmeFilename":"README.md","_rev":"1-8aabe97dedce3acbf520793562324daf"}