{"_id":"@0pi/mcp-server","_rev":"4-d7b818f835a6587589d6de5154aa27a4","name":"@0pi/mcp-server","dist-tags":{"latest":"1.0.3"},"versions":{"1.0.0":{"name":"@0pi/mcp-server","version":"1.0.0","keywords":["mcp","mcp-server","model-context-protocol","ai-agents","ai-workspace","context-caching","multi-agent","agent-communication","agent-bridge","ephemeral-storage","temporary-storage","pastebin","claude","gpt","llm-tools","agent-tools","workflow-bridge","dropbox-for-agents","0pi"],"author":{"name":"Des Conlon"},"license":"MIT","_id":"@0pi/mcp-server@1.0.0","maintainers":[{"name":"dizzydes","email":"desmondconlon@gmail.com"}],"homepage":"https://0pi.dev","bugs":{"url":"https://github.com/dizzydes/botbox/issues"},"bin":{"0pi-mcp":"index.js"},"dist":{"shasum":"1f0c159ed476714e7c1f9c62f83bcbdba19b0483","tarball":"https://registry.npmjs.org/@0pi/mcp-server/-/mcp-server-1.0.0.tgz","fileCount":8,"integrity":"sha512-DndfLxq5OgKGW9v/6YNLom839F8Y4UmNjkLpRNopl3rRq1pUHLKkgVSpFlZxzITh4EmyHPsPL/wiuphN9f9Zcg==","signatures":[{"sig":"MEUCIExoA3H7ThsIHkrqM0K3M0ckuxmLlkFVLA9d4f/WQzAAAiEA+OokR1UD5XQzwCUE4PdnETneeo6II7rQVSO04Ol8zxY=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":30027},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"2631d33bc6bbdc85bedd7099eb0c6053af2e92a1","scripts":{"test":"node test-mcp.sh","start":"node index.js"},"_npmUser":{"name":"dizzydes","email":"desmondconlon@gmail.com"},"repository":{"url":"git+https://github.com/dizzydes/botbox.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.7.0","description":"Ephemeral shared workspace for AI agents - cache contexts, bridge multi-agent workflows, and share data between sessions. Free 2-hour temporary storage.","directories":{},"_nodeVersion":"25.4.0","dependencies":{"axios":"^1.6.5","dotenv":"^16.4.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.0_1772733904416_0.37369334404629884","host":"s3://npm-registry-packages-npm-production"}},"1.0.1":{"name":"@0pi/mcp-server","version":"1.0.1","keywords":["mcp","mcp-server","model-context-protocol","ai-agents","ai-workspace","context-caching","multi-agent","agent-communication","agent-bridge","ephemeral-storage","temporary-storage","pastebin","claude","gpt","llm-tools","agent-tools","workflow-bridge","dropbox-for-agents","0pi"],"author":{"name":"Des Conlon"},"license":"MIT","_id":"@0pi/mcp-server@1.0.1","maintainers":[{"name":"dizzydes","email":"desmondconlon@gmail.com"}],"homepage":"https://0pi.dev","bugs":{"url":"https://github.com/dizzydes/botbox/issues"},"bin":{"0pi-mcp":"index.js"},"dist":{"shasum":"0b495c0d3f4ad4a7eb763b9b4d2b44dc275074f8","tarball":"https://registry.npmjs.org/@0pi/mcp-server/-/mcp-server-1.0.1.tgz","fileCount":11,"integrity":"sha512-0/ZAwoV6Q/3+Nc5Wh1NHzZRePOyLofeGKf27NS92rUILG4pd2KTBqBdcuN5X87Vuq4hoUry1DR78QS10vsRDFg==","signatures":[{"sig":"MEUCIAxJuVVOAqIZ0MfW856GnZxAIfK4tQp4worqroVIQUdtAiEA0e+42Ufj6/JByj2ZIJDBJ3FrB/XfrScHulkYVFgbW18=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":31628},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"2631d33bc6bbdc85bedd7099eb0c6053af2e92a1","mcpName":"io.github.dizzydes/0pi","scripts":{"test":"node test-mcp.sh","start":"node index.js"},"_npmUser":{"name":"dizzydes","email":"desmondconlon@gmail.com"},"repository":{"url":"git+https://github.com/dizzydes/botbox.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.7.0","description":"Ephemeral shared workspace for AI agents - cache contexts, bridge multi-agent workflows, and share data between sessions. Free 2-hour temporary storage.","directories":{},"_nodeVersion":"25.4.0","dependencies":{"axios":"^1.6.5","dotenv":"^16.4.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.1_1773420484140_0.6626665800647729","host":"s3://npm-registry-packages-npm-production"}},"1.0.2":{"name":"@0pi/mcp-server","version":"1.0.2","keywords":["mcp","mcp-server","model-context-protocol","ai-agents","ai-workspace","context-caching","multi-agent","agent-communication","agent-bridge","ephemeral-storage","temporary-storage","pastebin","claude","gpt","llm-tools","agent-tools","workflow-bridge","dropbox-for-agents","0pi"],"author":{"name":"Des Conlon"},"license":"MIT","_id":"@0pi/mcp-server@1.0.2","maintainers":[{"name":"dizzydes","email":"desmondconlon@gmail.com"}],"homepage":"https://0pi.dev","bugs":{"url":"https://github.com/dizzydes/botbox/issues"},"bin":{"0pi-mcp":"index.js"},"dist":{"shasum":"e1235bd13e99c3ae8c18b0b61b99ad5893f12aec","tarball":"https://registry.npmjs.org/@0pi/mcp-server/-/mcp-server-1.0.2.tgz","fileCount":12,"integrity":"sha512-HfDUtMHKRrz9+60K0ENGj6Gj6mE4ZDmPlEd7ynb8kVHfZuGc/Nv3SntiT9c0PQkFGvYCjFxdfzJRJwR8EDRTvQ==","signatures":[{"sig":"MEUCICTCem6hi1yLDqgoM9v6fkParE6M6QUIGqWdvUSPDu2jAiEA+QEI6QwEYu2XU2E72eD65k304KoJSAi37sEA4nbt6SU=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":34512},"main":"index.js","type":"module","engines":{"node":">=18.0.0"},"gitHead":"2631d33bc6bbdc85bedd7099eb0c6053af2e92a1","mcpName":"io.github.dizzydes/0pi","scripts":{"test":"node test-mcp.sh","start":"node index.js"},"_npmUser":{"name":"dizzydes","email":"desmondconlon@gmail.com"},"repository":{"url":"git+https://github.com/dizzydes/botbox.git","type":"git","directory":"mcp-server"},"_npmVersion":"11.7.0","description":"Ephemeral shared workspace for AI agents - cache contexts, bridge multi-agent workflows, and share data between sessions. Free 2-hour temporary storage.","directories":{},"_nodeVersion":"25.4.0","dependencies":{"axios":"^1.6.5","dotenv":"^16.4.0","@modelcontextprotocol/sdk":"^0.5.0"},"publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/mcp-server_1.0.2_1773421075734_0.33420717582563886","host":"s3://npm-registry-packages-npm-production"}},"1.0.3":{"name":"@0pi/mcp-server","version":"1.0.3","mcpName":"io.github.dizzydes/0pi","description":"Ephemeral shared workspace for AI agents - cache contexts, bridge multi-agent workflows, and share data between sessions. Free 2-hour temporary storage.","main":"index.js","type":"module","bin":{"0pi-mcp":"index.js"},"scripts":{"start":"node index.js","test":"node test-mcp.sh"},"keywords":["mcp","mcp-server","model-context-protocol","ai-agents","ai-workspace","context-caching","multi-agent","agent-communication","agent-bridge","ephemeral-storage","temporary-storage","pastebin","claude","gpt","llm-tools","agent-tools","workflow-bridge","dropbox-for-agents","0pi"],"repository":{"type":"git","url":"git+https://github.com/dizzydes/botbox.git","directory":"mcp-server"},"homepage":"https://0pi.dev","bugs":{"url":"https://github.com/dizzydes/botbox/issues"},"author":{"name":"Des Conlon"},"license":"MIT","publishConfig":{"access":"public"},"dependencies":{"@modelcontextprotocol/sdk":"^0.5.0","axios":"^1.6.5","dotenv":"^16.4.0"},"engines":{"node":">=18.0.0"},"gitHead":"2f568575eb83a51fe5b195e5cc2bd0c4d5a4e965","_id":"@0pi/mcp-server@1.0.3","_nodeVersion":"25.4.0","_npmVersion":"11.7.0","dist":{"integrity":"sha512-GD1OEYCsDy4o1iXox4y4EyUaQM9eutHetq5YwFF3W+KQAArUdAtii8CoiCoEkujhtErqwjnRxbuC74+edE5pDQ==","shasum":"207565406ff9f31a2ffaf47b43533e9c4e58a478","tarball":"https://registry.npmjs.org/@0pi/mcp-server/-/mcp-server-1.0.3.tgz","fileCount":12,"unpackedSize":34648,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIQCWsIUUwqZnSHSAdqCXUm2UDvcvMMQdrYRPiioeDqmBcAIgUBk9vZm+PI7penjqPafpKVXSmy1nyQBh6gCe/x0kvGo="}]},"_npmUser":{"name":"dizzydes","email":"desmondconlon@gmail.com"},"directories":{},"maintainers":[{"name":"dizzydes","email":"desmondconlon@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_1.0.3_1773422506381_0.8135398231690527"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-05T18:05:04.125Z","modified":"2026-03-13T17:21:46.681Z","1.0.0":"2026-03-05T18:05:04.558Z","1.0.1":"2026-03-13T16:48:04.314Z","1.0.2":"2026-03-13T16:57:55.865Z","1.0.3":"2026-03-13T17:21:46.538Z"},"bugs":{"url":"https://github.com/dizzydes/botbox/issues"},"author":{"name":"Des Conlon"},"license":"MIT","homepage":"https://0pi.dev","keywords":["mcp","mcp-server","model-context-protocol","ai-agents","ai-workspace","context-caching","multi-agent","agent-communication","agent-bridge","ephemeral-storage","temporary-storage","pastebin","claude","gpt","llm-tools","agent-tools","workflow-bridge","dropbox-for-agents","0pi"],"repository":{"type":"git","url":"git+https://github.com/dizzydes/botbox.git","directory":"mcp-server"},"description":"Ephemeral shared workspace for AI agents - cache contexts, bridge multi-agent workflows, and share data between sessions. Free 2-hour temporary storage.","maintainers":[{"name":"dizzydes","email":"desmondconlon@gmail.com"}],"readme":"# 0pi MCP Server\n\n> **Dropbox for AI Agents** - Ephemeral shared workspace for caching contexts and bridging multi-agent workflows\n\nA Model Context Protocol (MCP) server that enables AI agents to cache contexts, bridge workflows, and share ephemeral data via the 0pi API.\n\n## Use Cases\n\n🧠 **Context Caching** - Offload large contexts when approaching token limits  \n🤝 **Multi-Agent Bridge** - Share data between different AI agents seamlessly  \n📦 **Temporary Storage** - 2-hour auto-expiring storage for agent content  \n🔄 **Workflow Continuity** - Pass intermediate results between sessions  \n🌐 **Web Automation** - Store DOM snapshots for multi-step workflows  \n💾 **Code Sharing** - Temporary storage for generated code\n\n## Features\n\n- **Create Shared Workspaces**: Save large JSON structures, reasoning states, or DOM elements to the cloud\n- **Retrieve Workspaces**: Access previously saved data via workspace ID\n- **JSONL Logging**: All MCP interactions are logged locally in JSON Lines format for debugging and analytics\n- **Ephemeral Storage**: All data expires after 2 hours (configurable)\n\n## Installation\n\n### As a Local MCP Server\n\n1. **Install dependencies**:\n```bash\ncd mcp-server\nnpm install\n```\n\n2. **Configure environment** (optional):\n```bash\ncp .env.example .env\n# Edit .env to set AGENTBOX_API_URL if needed\n```\n\n3. **Run the server**:\n```bash\nnpm start\n```\n\n### Install via NPM (Future)\n\n```bash\nnpm install -g @agentbox/mcp-server\nagentbox-mcp\n```\n\n## Configuration with AI Tools\n\n### Claude Desktop\n\nAdd to your `claude_desktop_config.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentbox\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/botbox/mcp-server/index.js\"],\n      \"env\": {\n        \"AGENTBOX_API_URL\": \"https://0pi.dev\"\n      }\n    }\n  }\n}\n```\n\n### Cline (VS Code)\n\nAdd to your Cline MCP settings:\n\n```json\n{\n  \"mcpServers\": {\n    \"agentbox\": {\n      \"command\": \"node\",\n      \"args\": [\"/absolute/path/to/botbox/mcp-server/index.js\"],\n      \"env\": {\n        \"AGENTBOX_API_URL\": \"https://0pi.dev\"\n      }\n    }\n  }\n}\n```\n\n## Available Tools\n\n### 1. `create_shared_workspace`\n\nSave data to an ephemeral cloud workspace.\n\n**Parameters**:\n- `agent_id` (required): Your agent identifier (e.g., \"claude-coder\")\n- `data` (required): The payload to save (object, array, or string)\n- `intent` (optional): Brief description of why you're saving this\n- `ttl_seconds` (optional): Time-to-live in seconds (max 7200, default 7200)\n\n**Example**:\n```json\n{\n  \"agent_id\": \"claude-researcher\",\n  \"data\": {\n    \"research_findings\": [...],\n    \"next_steps\": [...]\n  },\n  \"intent\": \"Saving research results for coding agent\",\n  \"ttl_seconds\": 3600\n}\n```\n\n**Returns**:\n```json\n{\n  \"workspace_id\": \"a8f92k3d\",\n  \"url\": \"https://0pi.dev/w/a8f92k3d\",\n  \"expires_in\": 3600\n}\n```\n\n### 2. `get_shared_workspace`\n\nRetrieve data from a workspace.\n\n**Parameters**:\n- `workspace_id` (required): The 8-character workspace ID\n\n**Example**:\n```json\n{\n  \"workspace_id\": \"a8f92k3d\"\n}\n```\n\n**Returns**:\n```json\n{\n  \"agent_id\": \"claude-researcher\",\n  \"payload_type\": \"json\",\n  \"data\": { ... },\n  \"intent\": \"Saving research results for coding agent\",\n  \"created_at\": \"2026-05-03T13:57:56Z\"\n}\n```\n\n## JSONL Logging\n\nAll MCP interactions are logged to `logs/mcp-conversations.jsonl` in JSON Lines format (one JSON object per line).\n\n**Log Entry Format**:\n```json\n{\n  \"timestamp\": \"2026-05-03T13:57:56.123Z\",\n  \"event_type\": \"workspace_created\",\n  \"tool_name\": \"create_shared_workspace\",\n  \"agent_id\": \"claude-coder\",\n  \"workspace_id\": \"a8f92k3d\",\n  \"workspace_url\": \"https://0pi.dev/w/a8f92k3d\",\n  \"payload_size\": 15420,\n  \"intent\": \"saving DOM structure for handoff\",\n  \"error\": null,\n  \"metadata\": null\n}\n```\n\n**Event Types**:\n- `server_started`: MCP server initialized\n- `tools_listed`: Agent queried available tools\n- `tool_called`: Agent invoked a tool\n- `workspace_created`: Workspace successfully created\n- `workspace_creation_failed`: Error creating workspace\n- `workspace_retrieved`: Workspace data retrieved\n- `workspace_retrieval_failed`: Error retrieving workspace\n- `tool_execution_failed`: General tool execution error\n\n**Analyzing Logs**:\n```bash\n# View recent events (last 10 lines)\ntail -10 mcp-server/logs/mcp-conversations.jsonl\n\n# View all workspace creations\ncat mcp-server/logs/mcp-conversations.jsonl | grep \"workspace_created\"\n\n# Count events by type using jq\ncat mcp-server/logs/mcp-conversations.jsonl | jq -s 'group_by(.event_type) | map({event: .[0].event_type, count: length})'\n\n# View errors only\ncat mcp-server/logs/mcp-conversations.jsonl | jq 'select(.error != null)'\n\n# Count workspaces by agent\ncat mcp-server/logs/mcp-conversations.jsonl | jq -s 'map(select(.event_type == \"workspace_created\")) | group_by(.agent_id) | map({agent: .[0].agent_id, count: length})'\n```\n\n## Environment Variables\n\n- `AGENTBOX_API_URL`: Base URL for AgentBox API (default: `https://0pi.dev`)\n- `AGENTBOX_LOG_DIR`: Directory for log files (default: `./logs`)\n\n## Development\n\n```bash\n# Run in development\nnpm start\n\n# Test the server manually\necho '{\"jsonrpc\":\"2.0\",\"id\":1,\"method\":\"tools/list\"}' | node index.js\n```\n\n## Architecture\n\n```\n┌─────────────────┐\n│   AI Agent      │\n│  (Claude/GPT)   │\n└────────┬────────┘\n         │ MCP Protocol\n         │\n┌────────▼────────┐\n│  MCP Server     │\n│  (this package) │\n│                 │\n│  ┌───────────┐  │\n│  │  SQLite   │  │ (Local logging)\n│  │   Log     │  │\n│  └───────────┘  │\n└────────┬────────┘\n         │ HTTPS\n         │\n┌────────▼────────┐\n│  AgentBox API   │\n│  (0pi.dev)      │\n│                 │\n│  ┌───────────┐  │\n│  │   Redis   │  │ (Ephemeral storage)\n│  └───────────┘  │\n└─────────────────┘\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md"}