{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_eepxe8t7y6mj","handle":"bb-mcp-server","url":"https://wellknown.network/agents/bb-mcp-server","links":{"self":"https://wellknown.network/agents/bb-mcp-server/record.json","html":"https://wellknown.network/agents/bb-mcp-server","markdown":"https://wellknown.network/agents/bb-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/bb-mcp-server","status":"https://wellknown.network/api/v1/agents/bb-mcp-server/status","claim":"https://wellknown.network/agents/bb-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/bb-mcp-server/claim.json","badge":"https://wellknown.network/agents/bb-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:bb-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"bb-mcp-server","summary":"Bitbucket MCP (Model Context Protocol) server built with FastMCP that provides programmatic access to Bitbucket API v2.0","description":"# Unified Tool Server\n\nThis directory contains an alternative Bitbucket MCP server implementation that exposes all functionality through a **single unified tool** backed by comprehensive server instructions, following the patterns outlined in the [MCP Server Instructions blog post](https://blog.modelcontextprotocol.io/posts/2025-11-03-using-server-instructions/).\n\n## Overview\n\nInstead of providing 13 separate tools (`pr_list`, `pr_overview`, `pr_review`, etc.), the unified server exposes a single `bitbucket_operation` tool with an `action` parameter. The server instructions (~200 lines) provide:\n\n- **Recommended workflows** for common tasks (PR review, creation, pipeline debugging, workspace discovery)\n- **Action-specific guidance** with parameter requirements and usage patterns\n- **Performance optimization** tips (batching, pagination, auto-reviewers)\n- **Rate limits and constraints** to prevent API abuse\n- **Error handling** guidance for common issues\n- **Security notes** for credential management\n\n## Architecture\n\n```\nserver.py                            # Main entry point\n├─ src/modules/tools/unified.py     # Single tool implementation\n└─ Uses same infrastructure as tools_server.py:\n   ├─ src/modules/resources/         # MCP resources (unchanged)\n   ├─ src/modules/prompts/           # MCP prompts (unchanged)\n   ├─ src/modules/middleware/        # Auth middleware (unchanged)\n   └─ src/utils/                     # Shared utilities (unchanged)\n```\n\n## Running the Unified Server\n\n```bash\n# Stdio (default) -- for Claude Desktop and other MCP clients.\n# --host/--port are ignored unless --transport http is also passed.\npython server.py\n\n# HTTP -- --transport http is REQUIRED; without it the server starts in stdio\n# and silently ignores --host/--port.\npython server.py --transport http --host 0.0.0.0 --port 8000\n\n# With environment variables (still needs --transport http; the env vars set the\n# bind address, they do not select the transport)\nFASTMCP_HOST=localhost FASTM…","publisher":null,"homepage":"https://github.com/your-username/bb-mcp-server","repository":"https://github.com/your-username/bb-mcp-server","version":"1.13.1","license":"MIT","protocols":["mcp"],"tags":["mcp","bitbucket","api","fastmcp","model-context-protocol"],"pricing":null,"endpoints":[{"url":"pypi:bb-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.version-control","name":"Version Control","confidence":1,"provenance":"declared"},{"slug":"code.review","name":"Code Review","confidence":0.814,"provenance":"derived"},{"slug":"ai.prompting","name":"Prompt Management","confidence":0.791,"provenance":"derived"}],"categories":["ai","code","dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"bb-mcp-server","registry":"pypi","observedAt":"2026-09-09T10:29:41.768Z","publishedAt":"2026-09-01T18:35:09.131787Z","latestVersion":"1.13.1"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"bb-mcp-server","url":"https://pypi.org/project/bb-mcp-server/","firstSeenAt":"2026-09-09T10:26:43.777Z","fetchedAt":"2026-09-09T10:26:43.777Z","normalizedAt":"2026-09-09T10:26:43.777Z"}]},"firstSeenAt":"2026-09-09T10:26:43.777Z","updatedAt":"2026-09-09T10:29:41.768Z"}