Enables AI clients to access a tiered multimodal intelligence platform with governed request flows and quantum reasoning capabilities.
Also known as cuilabs/bee-community, bee-community, bee-sdk
- Stars
- 2
- Tools
- 8
- Downloads, 30 days
- 4,895
- Latest version
- 0.6.0
- Last commit
- Nov 14, 2026
- License
- Apache-2.0
What is Bee MCP?
Bee enables AI clients to access a tiered multimodal intelligence platform with governed request flows and quantum reasoning capabilities. It exposes 8 tools, such as bee_chat, bee_code, bee_security.
Summary generated from the project's README
About Bee MCP server
Bee provides a multimodal intelligence platform designed for developers who require governed request flows and quantum reasoning capabilities. This MCP server allows AI clients to connect to a tiered intelligence system, including a free Cell tier. Users can integrate this service through the bee-mcp command using uvx or by utilizing the provided Python and TypeScript SDKs.
To use the server, developers must obtain an API key from the Bee Workspace. The platform supports various specialized tasks such as tenant-scoped knowledge retrieval and explicit quantum reasoning. It is built to function within strict architectural boundaries, offering different execution contracts for mobile, desktop, and SDK requests. The system is designed for professional environments where security and provenance are important, providing tools for artifact inspection and integrity verification.
What you can do with it
- 1Perform quantum reasoning tasksAn AI client can be instructed to execute complex logic using the platform's specific reasoning capabilities.
- 2Retrieve tenant-specific knowledgeDevelopers can use the platform to perform retrieval-augmented generation within specific tenant boundaries.
- 3Implement governed coding workflowsThe system enables controlled programming assistance within an integrated development environment.
Written from the project's README. Every use case is checked against a quote from it.
How to install Bee MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall Bee MCP in Claude Code
$ claude mcp add --env 'BEE_API_KEY=<YOUR_BEE_API_KEY>' bee-community -- uvx --from bee-sdk bee-mcpInstall Bee MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"bee-community": {
"command": "uvx",
"args": [
"--from",
"bee-sdk",
"bee-mcp"
],
"env": {
"BEE_API_KEY": "<YOUR_BEE_API_KEY>"
}
}
}
}Install Bee MCP in VS Code
.vscode/mcp.json
{
"servers": {
"bee-community": {
"type": "stdio",
"command": "uvx",
"args": [
"--from",
"bee-sdk",
"bee-mcp"
],
"env": {
"BEE_API_KEY": "<YOUR_BEE_API_KEY>"
}
}
}
}Install Bee MCP in VS Code CLI
$ code --add-mcp '{"name":"bee-community","type":"stdio","command":"uvx","args":["--from","bee-sdk","bee-mcp"],"env":{"BEE_API_KEY":"<YOUR_BEE_API_KEY>"}}'Install Bee MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"bee-community": {
"command": "uvx",
"args": [
"--from",
"bee-sdk",
"bee-mcp"
],
"env": {
"BEE_API_KEY": "<YOUR_BEE_API_KEY>"
}
}
}
}Install Bee MCP in Codex
$ codex mcp add bee-community --env 'BEE_API_KEY=<YOUR_BEE_API_KEY>' -- uvx --from bee-sdk bee-mcpInstall Bee MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.bee-community] command = "uvx" args = ["--from", "bee-sdk", "bee-mcp"] [mcp_servers.bee-community.env] BEE_API_KEY = "<YOUR_BEE_API_KEY>"
Install Bee MCP in Gemini CLI
$ gemini mcp add -s user -e 'BEE_API_KEY=<YOUR_BEE_API_KEY>' bee-community uvx -- --from bee-sdk bee-mcpInstall Bee MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"bee-community": {
"command": "uvx",
"args": [
"--from",
"bee-sdk",
"bee-mcp"
],
"env": {
"BEE_API_KEY": "<YOUR_BEE_API_KEY>"
}
}
}
}Started by HostedMCP on 16 Nov 2026
We ran this command for bee-sdk 0.6.0 in an isolated container with no network and no keys. It answered and listed 8 tools.
Bee MCP tools 8
Read from the server with tools/listbee_chatRead-onlyAsk Bee anything. Bee — The Progressive Intelligence Engine — is a tiered LLM platform with per-domain specialisation. Optionally pick a domain and a model tier; both are limited to what your API key's plan allows. Bee is honest about uncertainty rather than fabricating.
bee_codeRead-onlyProgramming help from Bee's code specialist: explain code, fix a bug, refactor, or write tests — pick via `action`.
bee_securityRead-onlyBee's security specialist: audit code, build a threat model, assist authorised penetration testing, or review a smart contract — pick via `task`. Refuses weaponisation / unauthorised targets.
bee_researchRead-onlyBee's research specialist: design a quantum circuit (NISQ-honest, Qiskit) or critique an ML/CS paper — pick via `task`.
bee_documents_searchRead-onlySearch your Bee documents (RAG) — returns the top matching chunks with their source. Scoped to your account; requires a rag-entitled plan.
bee_documents_addActionAdd a document to your Bee knowledge base so bee_documents_search (and Bee) can use it. Scoped to your account; counts against your plan's document limit.
bee_memory_searchRead-onlySearch your Bee personal memory — facts, preferences, projects and skills Bee has remembered about you. Scoped to your account.
bee_memory_addActionSave a fact to your Bee personal memory so Bee recalls it in future conversations. Scoped to your account; near-duplicates are de-duplicated automatically.
| bee_chat | Ask Bee anything. Bee — The Progressive Intelligence Engine — is a tiered LLM platform with per-domain specialisation. Optionally pick a domain and a model tier; both are limited to what your API key's plan allows. Bee is honest about uncertainty rather than fabricating. | Read-only |
| bee_code | Programming help from Bee's code specialist: explain code, fix a bug, refactor, or write tests — pick via `action`. | Read-only |
| bee_security | Bee's security specialist: audit code, build a threat model, assist authorised penetration testing, or review a smart contract — pick via `task`. Refuses weaponisation / unauthorised targets. | Read-only |
| bee_research | Bee's research specialist: design a quantum circuit (NISQ-honest, Qiskit) or critique an ML/CS paper — pick via `task`. | Read-only |
| bee_documents_search | Search your Bee documents (RAG) — returns the top matching chunks with their source. Scoped to your account; requires a rag-entitled plan. | Read-only |
| bee_documents_add | Add a document to your Bee knowledge base so bee_documents_search (and Bee) can use it. Scoped to your account; counts against your plan's document limit. | Action |
| bee_memory_search | Search your Bee personal memory — facts, preferences, projects and skills Bee has remembered about you. Scoped to your account. | Read-only |
| bee_memory_add | Save a fact to your Bee personal memory so Bee recalls it in future conversations. Scoped to your account; near-duplicates are de-duplicated automatically. | Action |
Configuration
BEE_API_KEYRequiredSecretBee API key (bee_sk_…). Create one at https://bee.cuilabs.io/app/account/api-keys — the free Cell tier works.
BEE_API_URLOverride the gateway base URL (default https://bee.cuilabs.io/bee). Set only for a self-hosted Bee Enclave or staging.
BEE_MODELDefault model tier (bee-cell … bee-swarm). Tier access follows the API key's plan. Default: bee-cell (free).
| Name | Description | |
|---|---|---|
| BEE_API_KEY | Bee API key (bee_sk_…). Create one at https://bee.cuilabs.io/app/account/api-keys — the free Cell tier works. | RequiredSecret |
| BEE_API_URL | Override the gateway base URL (default https://bee.cuilabs.io/bee). Set only for a self-hosted Bee Enclave or staging. | |
| BEE_MODEL | Default model tier (bee-cell … bee-swarm). Tier access follows the API key's plan. Default: bee-cell (free). |
Automated checks
Ran Nov 16, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecuilabs/bee-community is public and reachablegithub.com/cuilabs/bee-community ↗Pass
- Package names this repository as its sourcebee-sdk names cuilabs/bee-community as sourcepypi.org/project/bee-sdk/ ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)Apache-2.0spdx.org/licenses/Apache-2.0.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-14github.com/cuilabs/bee-community ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from bee-sdkPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model8 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNo tool named like delete, drop or execPass
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubBee: Quantum Intelligence™
Website | Documentation | Packages | Machine-readable package index | System status
The public developer distribution for Bee, HEOSSI's governed multimodal intelligence platform. This repository contains the actual source of Bee's Apache-2.0 SDKs, MCP integration, API contracts, runnable examples, and public trust-verification material.
This repository is generated from reviewed, public-safe paths in the Bee monorepo. MANIFEST.json records the exact source commit and content digest for every export; SHA256SUMS and the SPDX SBOM support independent artifact inspection.
Developer surface
The canonical package catalog records each public developer distribution, exact version, registry, role, license boundary, and install command. Its machine-readable companion is PACKAGE-INDEX.json. These distributions do not expose the private Bee service monorepo.
| Surface | Install or entry point | Source / contract |
|---|---|---|
| TypeScript SDK | npm install @heossihq/bee |
sdks/typescript |
| Python SDK | pip install bee-sdk |
sdks/python |
| MCP server | uvx --from bee-sdk@latest bee-mcp |
mcp · server.json |
| OpenAI-compatible API | https://api.bee.heossi.com/bee |
openapi.json · postman.json |
| Bee: Quantum Intelligence - Code | Heossi.beecode |
Microsoft Marketplace · Open VSX |
| Bee Code CLI | npm install -g @heossihq/beecode |
Download guide |
| PQ assurance | Signed public coverage register | trust/pq-register |
Quickstart
import { BeeClient } from "@heossihq/bee";
const bee = new BeeClient({ apiKey: process.env.BEE_API_KEY! });
const result = await bee.chat.completions.create({
model: "bee-cell",
messages: [{ role: "user", content: "Explain hybrid post-quantum TLS." }],
});
console.log(result.choices[0].message.content);
Create an API key in Bee Workspace. The free Cell tier works with both SDKs and MCP.
Repository map
api/ Versioned OpenAPI and Postman contracts
docs/ Public architecture and enterprise scenario flows
examples/ Runnable TypeScript and Python examples
mcp/ Client configuration and MCP setup
sdks/typescript/ Published @heossihq/bee package source and tests
sdks/python/ Published bee-sdk and bee-mcp source and tests
trust/pq-register/ Public PQ coverage register and offline verification tools
Enterprise evaluation paths
| Evaluator | Start here | What can be verified publicly |
|---|---|---|
| Enterprise architect | Reference architecture and scenario flows | System boundaries, governed request flow, deployment profiles, and responsibility split |
| Security or risk lead | Security policy, PQ coverage register, and diligence index | Disclosure path, released PQ claims, evidence limitations, and public control references |
| Platform engineer | API contracts, SDKs, MCP, and examples | Integration contracts, install paths, source, examples, and client configuration |
| Procurement or technical diligence | MANIFEST.json, SHA256SUMS, SPDX SBOM, and NOTICE | Export provenance, file integrity, package inventory, licensing, and the public/proprietary boundary |
Architecture and scenarios
Start with the public reference architecture, then follow the control boundary through three concrete flows:
The matching visual architecture centre is published at bee.heossi.com/docs/architecture.
Bee Code's agent path is durable, subscription-bounded, and independently metered. Workspace, mobile, desktop, SDK, and MCP requests retain their own documented execution contracts; common entitlement enforcement does not imply that every surface has local IDE tools.
Integrity and provenance
The public distribution is locally rendered from an allowlisted monorepo surface. Verify it with:
sha256sum --check SHA256SUMS
python3 scripts/verify_bee_package_index.py PACKAGE-INDEX.json
SHA256SUMS covers every exported payload file except itself and the
commit-specific MANIFEST.json. The manifest separately binds the export to
its source commit and contains a deterministic digest of the complete payload.
The SPDX document is package-level (filesAnalyzed: false); it inventories the
published SDK and MCP packages without claiming a binary or deployment SBOM.
Public and proprietary boundary
The files in this repository are Apache-2.0 licensed. Bee's model engine, orchestration plane, hosted gateway, Bee Code CLI implementation, editor-extension implementation, and commercial applications remain proprietary and are not represented as open source here. Public API and package behavior is defined by the contracts and SDK source in this repository.
Support and security
- SDK, MCP, contract, or example defect: open an issue
- Product or account support: bee.heossi.com/contact
- Vulnerability disclosure:
bee-security@heossi.com; see SECURITY.md - Service health: status · changelog · roadmap
Contributing
Read CONTRIBUTING.md, SUPPORT.md, and the Code of Conduct. Generated paths must be changed in their canonical monorepo source; community examples and documentation can be proposed here and are reconciled during the next local export.
License
Apache License 2.0 · Copyright 2026 HEOSSI (Pte.) Ltd.
Bee™ and the Bee knot logo are trademarks of HEOSSI (Pte.) Ltd., Singapore.
Bee MCP questions
How do I add Bee MCP to Claude Code?
Run claude mcp add --env 'BEE_API_KEY=<YOUR_BEE_API_KEY>' bee-community -- uvx --from bee-sdk bee-mcp in your terminal. Add --scope user to make it available in every project.
How do I add Bee MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What tools does Bee MCP provide?
It exposes 8 tools, including bee_chat, bee_code, bee_security, bee_research, bee_documents_search.
How do I install the Bee MCP server?
You can install the MCP server using the command: uvx --from bee-sdk@latest bee-mcp.
Is there a free tier available for Bee?
Yes, the free Cell tier is available and works with both the SDKs and the MCP server.