{"_id":"@bolospot/mcp","name":"@bolospot/mcp","dist-tags":{"latest":"0.4.3"},"versions":{"0.4.3":{"name":"@bolospot/mcp","version":"0.4.3","description":"MCP server for Bolo — peer-to-peer digital permissions for AI agents","type":"module","main":"dist/index.js","types":"dist/index.d.ts","bin":{"bolo-mcp":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsx src/index.ts","start":"node dist/index.js","typecheck":"tsc --noEmit","test":"node --experimental-vm-modules node_modules/.bin/jest"},"keywords":["mcp","bolo","permissions","grants","calendar","ai","scheduling","agent","openclaw","claude","peer-to-peer"],"dependencies":{"@modelcontextprotocol/sdk":"^1.27.1"},"devDependencies":{"@types/jest":"^29.5.11","@types/node":"^20.10.6","jest":"^29.7.0","ts-jest":"^29.1.1","tsx":"^4.7.0","typescript":"^5.3.3"},"engines":{"node":">=20.0.0"},"gitHead":"5b166efcac3bd698af80bfe8ad74cd94dd67ec0b","_id":"@bolospot/mcp@0.4.3","_nodeVersion":"22.20.0","_npmVersion":"11.6.3","dist":{"integrity":"sha512-s3nUzWh24kEjwHcegKsRiFinaWzhHcjunnETUlUrM24CFmPvqp0/WNsNJaa54dImr8eO8O8b0thgRf/fQGTCVQ==","shasum":"cbb7673ad5fa844a4d388445de5b09fb6db90bf5","tarball":"https://registry.npmjs.org/@bolospot/mcp/-/mcp-0.4.3.tgz","fileCount":122,"unpackedSize":114340,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIEoGCMobxrkbWvEulEyX7qO4Z6tz1xiX9Z5ZIRDhFSboAiEAoHYaokFTSAlc2xzY/ebIu+nEnfjhmblSxa46RpvvbQg="}]},"_npmUser":{"name":"bolo-ai","email":"alison@claritrace.com"},"directories":{},"maintainers":[{"name":"bolo-ai","email":"alison@claritrace.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp_0.4.3_1774472256392_0.742108000272083"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-25T20:57:36.332Z","0.4.3":"2026-03-25T20:57:36.562Z","modified":"2026-03-25T20:57:36.729Z"},"maintainers":[{"name":"bolo-ai","email":"alison@claritrace.com"}],"description":"MCP server for Bolo — peer-to-peer digital permissions for AI agents","keywords":["mcp","bolo","permissions","grants","calendar","ai","scheduling","agent","openclaw","claude","peer-to-peer"],"readme":"# Bolo MCP Server\n\n> Be on the look out for your ID. Your AI gatekeeper.\n\nMCP (Model Context Protocol) server for Bolo — peer-to-peer digital permissions for AI agents. Connect your calendar, manage trust grants, and let agents communicate through the relay.\n\n## Installation\n\n```bash\nnpm install -g bolo-mcp\n# or use npx for zero-install\nnpx bolo-mcp\n```\n\n## Configuration\n\nAdd to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json` on Mac):\n\n```json\n{\n  \"mcpServers\": {\n    \"bolo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"bolo-mcp\"],\n      \"env\": {\n        \"BOLO_API_KEY\": \"bolo_live_...\"\n      }\n    }\n  }\n}\n```\n\nGet your API key at [bolospot.com/dashboard/api-keys](https://bolospot.com/dashboard/api-keys).\n\n## Toolsets\n\nControl which tools are exposed with `BOLO_TOOLSET`:\n\n| Toolset | Tools | For |\n|---------|-------|-----|\n| `developer` | 14 | Widget builders (relay, grants, widget registration) |\n| `scheduling` | 7 | Scheduling agents (availability, booking, events) |\n| `account` | 4 | Profile and settings management |\n| `all` | 21 | Everything (default) |\n\n```json\n{\n  \"env\": {\n    \"BOLO_API_KEY\": \"bolo_live_...\",\n    \"BOLO_TOOLSET\": \"developer\"\n  }\n}\n```\n\n## Available Tools (21)\n\n### Scheduling\n- **get_availability** — busy periods or bookable time slots for a @handle\n- **find_mutual_time** — find when multiple people are all free\n- **get_booking_profile** — public booking profile (durations, working hours)\n- **book_meeting** — book a meeting with a @handle or email\n- **get_events** — calendar events (your own or another @handle's)\n\n### Permissions & Grants\n- **check_access** — what has a @handle shared with you (includes booking tier)\n- **request_access** — request access to a permission category\n- **create_grant** — grant access to another @handle\n- **revoke_grant** — revoke a previously created grant\n- **list_bolos** — list grants sent, received, or both\n\n### Agent Relay\n- **relay_send** — send a query through the trust boundary\n- **relay_inbox** — check for incoming queries\n- **relay_reply** — reply to a query\n- **relay_check_responses** — poll for responses to your queries\n- **relay_ack** — acknowledge processed messages\n\n### Widget Development\n- **register_widget** — register a new permission category for your app\n- **update_widget** — update a registered widget\n- **deactivate_widget** — deactivate a registered widget\n- **list_widgets** — list all available permission categories\n\n### Identity & Profile\n- **lookup_handle** — check if a @handle is registered\n- **update_profile** — update profile, availability, and booking settings\n\n## Quick Example\n\n```\nUser: \"Schedule a 30-min call with @alice next week\"\n\nClaude → check_access(\"@alice\")                    # grants + booking tier\n       → get_availability(\"@alice\", duration: 30)  # bookable slots\n       → book_meeting(...)                         # confirmed\n```\n\n## Full Documentation\n\nSee [bolospot.com/docs/mcp-tools](https://bolospot.com/docs/mcp-tools) for complete tool reference with parameters and examples.\n\n## Development\n\n```bash\npnpm install\npnpm dev        # run with tsx\npnpm build      # compile TypeScript\npnpm start      # run compiled\n```\n\n## License\n\nMIT\n","readmeFilename":"README.md","_rev":"1-af2455030797f0922f144c324ac2ffb4"}