# Archbee MCP for AI Agents AI Agent Connect > Archbee MCP lets you manage documentation spaces, sync OpenAPI specs, and organize technical knowledge directly from your AI agent. It handles everything from creating new spaces to searching your entire knowledge base for specific details. ## Overview - **Category:** developer-tools - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_fCnM2uViY4qOyvO2XGpYY1I9uSnnN9ClQwZUddd2/ai-agent-connect - **Tags:** documentation, openapi, technical-writing, api-docs, knowledge-base ## Description Archbee makes your documentation a living part of your development cycle. Instead of jumping between your IDE, a browser tab for your docs, and a Swagger UI, you just tell your agent to update the auth flow. This Connector allows you to interact with your organization using natural language. You can have your agent grab a raw OpenAPI spec and push it into the right document tree, or ask it to find that one obscure deployment guide from six months ago. It treats your docs like a searchable database rather than a static pile of files. When you're looking for a way to restructure your entire docs site, you don't have to click through nested folders; you just describe the new organization and let the agent handle the heavy lifting. It's about making sure the documentation actually keeps up with the code. By connecting it through the Vinkius catalog, you get a way to keep your technical knowledge organized without the friction of manual copy-pasting or constant tab-switching. ## Tools ### info_openapi Get details about a synced OpenAPI document. This provides context on your API definitions within your docs. ### merge_suggestion Accept a suggested change into the main document. Use this to incorporate approved edits into your primary content. ### publish_space Push a documentation space to a specific environment. This moves your docs from a draft state to a live production site. ### search_docs Search for any document across your organization. This helps you find specific guides or specs in seconds. ### sync_openapi Sync an OpenAPI definition to an Archbee document. This ensures your API documentation always matches your code. ### delete_space_group Delete a group of documentation spaces. This helps you quickly reorganize your high-level documentation structure. ### get_doc Read the content of a specific document. This allows your agent to pull in the exact details you need to discuss. ### update_space Change the settings or metadata for a space. Use this to adjust how your documentation areas are organized. ### create_space Create a new documentation space for a project or team. This helps keep your various projects organized in distinct areas. ### create_update_doc Write new documents or edit existing ones in Markdown. This lets you manage content without leaving your AI chat. ### delete_doc Remove a specific document from your organization. Use this to clean up old or obsolete files instantly. ### delete_space Permanently remove a documentation space. Use this to get rid of entire project areas you no longer need. ### discard_suggestion Reject a suggested change to a document. This keeps your primary documentation accurate by ignoring unwanted edits. ### get_display_rules See the organization-wide display rules. This helps you understand how content is presented across your docs. ### export_organization Download your entire organization's data. Use this to move your knowledge base to another format or location. ### import_content Put Markdown content into a specific document. This makes it easy to move text from your notes into your official docs. ### upload_file Put a file into Archbee storage. This lets you store extra assets like images or configuration files. ### clone_space Make a copy of an existing documentation space. This helps you quickly set up a new space based on a template. ### create_space_group Group multiple spaces together. This creates a better structure for managing large amounts of documentation. ## Prompt Examples **Prompt:** ``` Find the auth guide in my docs. ``` **Response:** ``` I found 3 documents related to 'authentication flow'. The most relevant is **OAuth2 Implementation Guide** (ID: auth_9921). Would you like me to retrieve its content? ``` **Prompt:** ``` Sync this OpenAPI YAML content to document tree 8821. ``` **Response:** ``` Starting OpenAPI synchronization... **Success!** The API definition has been successfully synced to the document tree. The 'Try It' feature is now enabled as requested. ``` **Prompt:** ``` Create a new document in Archbee with the title 'Onboarding' and content '# Welcome...' ``` **Response:** ``` I've created the **Onboarding** document. | Document Name | Status | ID | | :--- | :--- | :--- | | Onboarding | Created | doc_xyz789 | You can access it or update it further using that ID. ``` ## Capabilities ### Create documentation spaces Set up new areas for different projects or teams. ### Sync OpenAPI specs Automatically push API definitions to your docs. ### Search the whole knowledge base Find specific details across your entire organization instantly. ### Manage document lifecycles Create, update, and delete docs using plain Markdown. ### Import Markdown content Bring existing files into your structured documentation. ## Use Cases ### Syncing a new API endpoint A developer asks their agent to sync a new OpenAPI YAML file to the public documentation. The agent uses sync_openapi to update the document tree and enables the Try It feature. ### Finding specific auth guides A product manager asks their agent how the OAuth flow works. The agent uses search_docs to find the correct guide and retrieves the content for them. ### Updating onboarding docs A technical writer wants to update the onboarding process. They ask the agent to create_update_doc with new Markdown content to keep the guide current. ### Organizing project spaces A lead engineer wants to group all microservice docs together. They ask the agent to use create_space_group to organize the documentation structure. ## Benefits - Keep your API docs in sync with your code automatically by using sync_openapi to push definitions to your doc trees. - Find any technical detail in seconds using search_docs to query your entire knowledge base across all spaces. - Draft and edit documentation in plain Markdown using create_update_doc without switching windows. - Organize your knowledge base effectively by using create_space_group to structure multiple documentation areas. - Move existing notes into your official docs quickly by using import_content to pull in Markdown files. - Manage your production releases by using publish_space to push documentation to specific environments. ## How It Works The bottom line is your documentation becomes a living, searchable asset that your agent can actually interact with. 1. Subscribe to the Archbee MCP and grab your API key. 2. Plug the key into your AI client like Claude or Cursor. 3. Start asking your agent to write, search, or sync your docs. ## Frequently Asked Questions **Can Archbee MCP help me keep my API docs updated?** Yes, it can sync your OpenAPI definitions directly to your documentation trees. This ensures your docs always reflect your latest code changes without manual editing. **How do I use Archbee MCP to find specific info?** You can ask your agent to search your entire knowledge base. It will look through all your documents and spaces to find the specific technical details you need. **Can I use Archbee MCP with Cursor?** Yes, you can connect Archbee to Cursor or any MCP-compatible client. Once connected, your agent can manage your docs directly from your IDE. **Does Archbee MCP support Markdown?** Yes, it uses Markdown as the primary format. You can create, update, and manage your documents using plain Markdown text. **Can Archbee MCP manage my documentation spaces?** Yes, it allows you to create, clone, update, and group documentation spaces. This helps you organize your knowledge into a logical structure. **How does Archbee MCP handle OpenAPI files?** It takes your JSON or YAML definitions and syncs them to your document trees. This helps you keep your API documentation accurate and easy to read. **Is Archbee MCP good for technical writers?** It is excellent for technical writers who need to manage document lifecycles, publish updates to different environments, and keep documentation organized. **Can I synchronize my Swagger or OpenAPI files to Archbee using this server?** Yes! Use the `sync_openapi` tool. You can provide the file content and the target document tree ID to automatically update your API documentation. **How do I search for a specific topic across all my documents?** Use the `search_docs` tool with your search query. The AI will return a list of relevant documents found within your Archbee organization. **Is it possible to publish a documentation space to a live environment?** Absolutely. Use the `publish_space` tool and specify the target environment to make your documentation updates live.