{"_id":"@bizra/mcp-server","name":"@bizra/mcp-server","dist-tags":{"latest":"0.1.0"},"versions":{"0.1.0":{"name":"@bizra/mcp-server","version":"0.1.0","description":"Bizra MCP Server — query research knowledge from Claude Desktop, Cursor, or any MCP client","main":"dist/index.js","types":"dist/index.d.ts","bin":{"bizra-mcp-server":"dist/index.js"},"scripts":{"build":"tsc","dev":"tsc --watch","start":"node dist/index.js","prepublishOnly":"npm run build"},"dependencies":{"@modelcontextprotocol/sdk":"^1.12.1"},"devDependencies":{"typescript":"^5.7.0","@types/node":"^20.17.0"},"keywords":["bizra","mcp","research","claude-desktop","model-context-protocol"],"license":"MIT","homepage":"https://bizra.io","repository":{"type":"git","url":"git+https://github.com/bizra-io/bizra-platform.git","directory":"packages/mcp-server"},"bugs":{"url":"https://github.com/bizra-io/bizra-platform/issues"},"engines":{"node":">=18"},"publishConfig":{"access":"public"},"gitHead":"ff161d40a465d92260ee2bc73f5342579283d154","_id":"@bizra/mcp-server@0.1.0","_nodeVersion":"25.8.1","_npmVersion":"11.11.0","dist":{"integrity":"sha512-E1qn+5R6Ob4Jgtu66XIkng5FUDgJo6w17LzGsxze+61hku4cjwTQtqU0b6bMjZjdQmuQDG2JGEtxyEMiRnxPrA==","shasum":"827929ffa1c803b8498bd85a91d1c9c4692124dc","tarball":"https://registry.npmjs.org/@bizra/mcp-server/-/mcp-server-0.1.0.tgz","fileCount":15,"unpackedSize":46456,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQCP50TUd+3cgbJKx50pePf7UW6T3wB3jY3UoJXXA90cdwIhAI6luRlFxUpEIF6uB0bV1rrq98Gqnve09HBJ1vLhAh0w"}]},"_npmUser":{"name":"adminbizra","email":"admin@bizra.io"},"directories":{},"maintainers":[{"name":"adminbizra","email":"admin@bizra.io"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/mcp-server_0.1.0_1777392458704_0.7298656012052354"},"_hasShrinkwrap":false}},"time":{"created":"2026-04-28T16:07:38.637Z","0.1.0":"2026-04-28T16:07:38.833Z","modified":"2026-04-28T16:07:39.066Z"},"maintainers":[{"name":"adminbizra","email":"admin@bizra.io"}],"description":"Bizra MCP Server — query research knowledge from Claude Desktop, Cursor, or any MCP client","homepage":"https://bizra.io","keywords":["bizra","mcp","research","claude-desktop","model-context-protocol"],"repository":{"type":"git","url":"git+https://github.com/bizra-io/bizra-platform.git","directory":"packages/mcp-server"},"bugs":{"url":"https://github.com/bizra-io/bizra-platform/issues"},"license":"MIT","readme":"# Bizra MCP Server\n\nConnect [Bizra](https://bizra.io) — the Research OS — to any Model Context Protocol (MCP) client. Query research findings, opportunities, and studies directly from Claude Desktop, Cursor, or any tool that speaks MCP.\n\n## Install\n\nNo global install needed — run via `npx`:\n\n```bash\nnpx -y @bizra/mcp-server\n```\n\n## Configuration\n\nThe server requires a Bizra API key. Create one at **Settings → API Keys** in the Bizra app, then set it as an environment variable:\n\n| Variable | Required | Default |\n|----------|----------|---------|\n| `BIZRA_API_KEY` | Yes | — |\n| `BIZRA_API_URL` | No | `https://app.bizra.io` |\n\n## Claude Desktop\n\nAdd this to `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows):\n\n```json\n{\n  \"mcpServers\": {\n    \"bizra\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bizra/mcp-server\"],\n      \"env\": {\n        \"BIZRA_API_KEY\": \"biz_live_xxxxxxxxxxxxxxxxxxxxxxxx\"\n      }\n    }\n  }\n}\n```\n\nRestart Claude Desktop. You should see the Bizra tools in the tool list.\n\n## Cursor\n\nAdd to `~/.cursor/mcp.json`:\n\n```json\n{\n  \"mcpServers\": {\n    \"bizra\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@bizra/mcp-server\"],\n      \"env\": { \"BIZRA_API_KEY\": \"biz_live_xxxxxxxxxxxxxxxxxxxxxxxx\" }\n    }\n  }\n}\n```\n\n## Tools\n\n| Tool | What it does |\n|------|--------------|\n| `bizra_search` | Semantic search over your org's opportunities |\n| `bizra_get_study` | Fetch a study with findings + metadata |\n| `bizra_get_opportunity` | Fetch an opportunity with linked findings + confidence |\n| `bizra_list_recent` | List the most recently updated studies |\n| `bizra_draft_study` | Scaffold a new interview or survey study from a topic |\n| `bizra_import_document` | Submit a document (URL or pasted text) for import as a qual study |\n| `bizra_import_from_url` | Submit a Google Doc / Notion / OneDrive URL for import |\n| `bizra_import_behavioral` | Submit a SQL plan for behavioral data import (Snowflake / BigQuery) |\n| `bizra_get_import_status` | Check whether a pending import has been approved + extracted |\n| `bizra_get_survey_results` | Fetch aggregated survey results (charts, cross-tabs, NPS) |\n| `bizra_analyze_survey` | Ask a natural-language question about a survey's results |\n\nAll write tools (`bizra_draft_study`, `bizra_import_*`) create **drafts** that a researcher reviews and approves inside Bizra. Nothing is published automatically.\n\n## Authentication\n\nThe API key carries org + role scope. Tools never see data outside the org the key was issued for.\n\nPer-org admins can disable MCP access entirely via **Settings → Workspace → MCP Access** in the Bizra app.\n\n## Logs + debugging\n\nThe server writes to stderr — Claude Desktop captures these logs at `~/Library/Logs/Claude/mcp-server-bizra.log`.\n\nSet `BIZRA_API_URL=http://localhost:3002` to point at a local Bizra dev server instead of production.\n\n## License\n\nMIT — see `LICENSE`.\n\n## Issues\n\n[github.com/bizra-io/bizra-platform/issues](https://github.com/bizra-io/bizra-platform/issues)\n","readmeFilename":"README.md","_rev":"1-3d1f624fedb4369d0ec0476db4f500c4"}