{"_id":"@beachio/gleo-mcp","_rev":"2-0fd0d80d45f7ae879e5da2a1896941a2","name":"@beachio/gleo-mcp","dist-tags":{"latest":"1.1.0"},"versions":{"1.0.0":{"name":"@beachio/gleo-mcp","version":"1.0.0","keywords":["mcp","gleo","model-context-protocol","claude","cursor","ai"],"author":{"name":"Beach.io"},"license":"MIT","_id":"@beachio/gleo-mcp@1.0.0","maintainers":[{"name":"stevebeach","email":"steve@beach.io"}],"homepage":"https://github.com/beachio/gleo-api#readme","bugs":{"url":"https://github.com/beachio/gleo-api/issues"},"bin":{"gleo-mcp":"index.js"},"dist":{"shasum":"515807bcb06c11b0f186e8d862a37f167869ea7d","tarball":"https://registry.npmjs.org/@beachio/gleo-mcp/-/gleo-mcp-1.0.0.tgz","fileCount":3,"integrity":"sha512-Z6Og4VcbvpdZwlk4VBz30QW5yWGqtK4Lm4bXrEAMSAiXkbhut8qdaOA9dDfcF5V6dAe+Z5gGpQx0a3pP86d9kA==","signatures":[{"sig":"MEUCIBFA3ZphHYT2rPJ8g5m8E1XRvoPj0KjjynWpWwZc0vspAiEAwlkvFle9ZTwTt7g6ANYacedZn11L4BHAXYKlZMpiuuQ=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":8972},"main":"index.js","engines":{"node":">=18"},"gitHead":"699ca9bfa079193bc0e8c7da32963d4d29388cee","_npmUser":{"name":"stevebeach","email":"steve@beach.io"},"repository":{"url":"git+https://github.com/beachio/gleo-api.git","type":"git","directory":"packages/mcp-bridge"},"_npmVersion":"11.3.0","description":"MCP bridge for connecting Claude Desktop, Cursor, and other MCP clients to the Gleo API","directories":{},"_nodeVersion":"24.1.0","publishConfig":{"access":"public"},"_hasShrinkwrap":false,"_npmOperationalInternal":{"tmp":"tmp/gleo-mcp_1.0.0_1774898303379_0.36487392473602487","host":"s3://npm-registry-packages-npm-production"}},"1.1.0":{"name":"@beachio/gleo-mcp","version":"1.1.0","description":"MCP bridge for connecting Claude Desktop, Cursor, and other MCP clients to the Gleo API","main":"index.js","bin":{"gleo-mcp":"index.js"},"engines":{"node":">=18"},"keywords":["mcp","gleo","model-context-protocol","claude","cursor","ai"],"author":{"name":"Beach.io"},"license":"MIT","publishConfig":{"access":"public"},"repository":{"type":"git","url":"git+https://github.com/beachio/gleo-api.git","directory":"packages/mcp-bridge"},"_id":"@beachio/gleo-mcp@1.1.0","gitHead":"f6c8c5467182a607e896d702a226b4540fe1a564","bugs":{"url":"https://github.com/beachio/gleo-api/issues"},"homepage":"https://github.com/beachio/gleo-api#readme","_nodeVersion":"24.1.0","_npmVersion":"11.3.0","dist":{"integrity":"sha512-Qm/pTTbZqDpwI03u7K68mfrSioV8gVwb+Abm/9P2Jp2xgExsmXWv99caJds5EQQIt2g9er16g3vapz3wZnkktw==","shasum":"fcc1e99fc832ed5360ed1889bbcc182a0e34ca2d","tarball":"https://registry.npmjs.org/@beachio/gleo-mcp/-/gleo-mcp-1.1.0.tgz","fileCount":3,"unpackedSize":9543,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEQCIE1PFOuQ+WEUopiwYTAaN8hZXzlovcPKwNiYFNstvjfmAiBaKBjT1Xmrp0IHSyXwmIBqDxoyPHHYjrHgFf6FrMQ1aQ=="}]},"_npmUser":{"name":"stevebeach","email":"steve@beach.io"},"directories":{},"maintainers":[{"name":"stevebeach","email":"steve@beach.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/gleo-mcp_1.1.0_1779898171852_0.139924834317531"},"_hasShrinkwrap":false}},"time":{"created":"2026-03-30T19:18:23.246Z","modified":"2026-05-27T16:09:32.121Z","1.0.0":"2026-03-30T19:18:23.545Z","1.1.0":"2026-05-27T16:09:31.990Z"},"bugs":{"url":"https://github.com/beachio/gleo-api/issues"},"author":{"name":"Beach.io"},"license":"MIT","homepage":"https://github.com/beachio/gleo-api#readme","keywords":["mcp","gleo","model-context-protocol","claude","cursor","ai"],"repository":{"type":"git","url":"git+https://github.com/beachio/gleo-api.git","directory":"packages/mcp-bridge"},"description":"MCP bridge for connecting Claude Desktop, Cursor, and other MCP clients to the Gleo API","maintainers":[{"name":"stevebeach","email":"steve@beach.io"}],"readme":"# @beachio/gleo-mcp\n\nMCP bridge for connecting Claude Desktop, Cursor, and other MCP-compatible clients to the [Gleo](https://gleo.com) API.\n\n## What it does\n\nThis bridge runs locally as a stdio process. Your MCP client (Claude Desktop, Cursor, etc.) launches it, and it forwards JSON-RPC calls to the Gleo HTTP API using your personal API token.\n\n## Requirements\n\n- Node.js 18 or later\n- A Gleo account with an MCP token (see Setup below)\n\n## Setup\n\n### 1. Generate an MCP token\n\n1. Sign in to Gleo and go to **Settings > Developer**\n2. Under **MCP Tokens**, click **Create new token**\n3. Give it a label (e.g. \"My Cursor Setup\") and click **Create**\n4. Copy the token — it is only shown once\n\n### 2. Configure your MCP client\n\n#### Claude Desktop\n\nEdit `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"gleo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@beachio/gleo-mcp\"],\n      \"env\": {\n        \"GLEO_TOKEN\": \"gleo_mcp_your_token_here\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop after saving.\n\n#### Cursor\n\nEdit `.cursor/mcp.json` in your project root, or the global Cursor MCP config:\n\n```json\n{\n  \"mcpServers\": {\n    \"gleo\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@beachio/gleo-mcp\"],\n      \"env\": {\n        \"GLEO_TOKEN\": \"gleo_mcp_your_token_here\"\n      }\n    }\n  }\n}\n```\n\n#### Global install (optional)\n\nIf you prefer not to use `npx` each time:\n\n```bash\nnpm install -g @beachio/gleo-mcp\n```\n\nThen use `\"command\": \"gleo-mcp\"` instead of `\"command\": \"npx\"` / `\"args\": [\"-y\", \"@beachio/gleo-mcp\"]`.\n\n## Environment variables\n\n| Variable | Required | Default | Description |\n|---|---|---|---|\n| `GLEO_TOKEN` | Yes | — | Your MCP API token from Gleo Settings |\n| `GLEO_API_URL` | No | `https://api.gleo.com/mcp` | Override the API endpoint |\n| `GLEO_RESPONSE_FORMAT` | No | `json` | Tool response format: `json` or `toon` |\n\nWhen `GLEO_RESPONSE_FORMAT=toon`, the bridge sends `X-Gleo-Response-Format: toon` on every request. Tool results are returned as compact [TOON](https://github.com/toon-format/toon) instead of JSON — useful for long workflows with many list/search calls.\n\n## Available tools\n\nThe bridge exposes all Gleo MCP tools, including:\n\n- `get_artifact`, `search_artifacts`, `create_artifact`, `semantic_search_artifacts`\n- `list_sessions`, `get_session`, `create_session`\n- `list_playbooks`, `get_playbook`, `create_playbook_session`\n- `list_playbook_templates`, `get_playbook_template`\n- `list_playbook_questions`, `create_playbook_question`, `add_playbook_question_answer`\n- `list_playbook_tasks`, `create_playbook_task`\n- `create_agenda_item`, `create_agenda_items`, `update_agenda_item`, `delete_agenda_item`\n- `create_prep_activity`, `create_prep_activities`\n- `list_playbook_artifacts`, `create_playbook_artifact`\n- `link_artifact_to_source`\n- `list_playbook_question_tags`, `attach_question_tag`, `detach_question_tag`\n- `toggle_playbook_question_reaction`\n\n## Troubleshooting\n\n**\"GLEO_TOKEN environment variable is required\"** — set the `GLEO_TOKEN` env var in your MCP client config.\n\n**\"Invalid token\"** — verify the token was copied correctly and has not been deleted or regenerated in Gleo Settings.\n\n**Timeout errors** — check your network connection to `api.gleo.com`.\n\n## License\n\nMIT\n","readmeFilename":"README.md"}