# Archbee MCP

> Archbee MCP: Manage your entire technical knowledge base directly through natural language instructions. This connector lets you create, update, and manage documentation spaces, synchronize OpenAPI specs, and query deep product guides without leaving your AI client. It’s the direct pipeline to keeping your company's technical documentation current and searchable.

## Overview
- **Category:** developer-tools
- **Price:** Free
- **Tags:** documentation, openapi, technical-writing, api-docs, knowledge-base

## Description

Connecting Archbee gives your agent full control over your technical writing workflows. You can treat your entire knowledge base like a single document—you don't have to jump between tools or interfaces to find information. For instance, you can ask it to perform a global search across every guide and requirement the company has ever written. Need to update an API definition? The MCP lets you sync OpenAPI specs right into specific documentation trees, making sure your 'Try It' features are always up to date. If your current workflow is scattered across multiple systems, connecting Archbee via Vinkius gives you one central place where your AI client handles all the complexity, letting you focus only on what needs writing or fixing.

## Tools

### clone_space
Makes a complete duplicate copy of an existing documentation space structure.

### create_space_group
Gathers multiple spaces into one logical container group for better organization.

### create_space
Builds a brand-new, empty documentation space from scratch.

### create_update_doc
Adds new content to a document or modifies the text of an existing one.

### delete_doc
Permanently removes a specific documentation file from the system.

### delete_space_group
Removes an entire grouping of related spaces.

### delete_space
Permanently wipes out an entire documentation space and all its contents.

### discard_suggestion
Tells the agent to ignore a suggested change it has made to a document.

### get_display_rules
Retrieves all organizational settings that dictate how documentation appears to users.

### export_organization
Downloads a complete copy of the entire organization's data for backup or migration purposes.

### get_doc
Retrieves and shows the full text content of a specific document by its ID.

### import_content
Takes raw Markdown text and inserts it into an existing or new document.

### info_openapi
Provides metadata and structure details about a previously synchronized OpenAPI definition.

### merge_suggestion
Combines changes from a suggested draft document into the primary, published version of a document.

### publish_space
Makes a documentation space live and available to users in a specific environment.

### search_docs
Searches through the text content of all documents within your organization's knowledge base for keywords or phrases.

### sync_openapi
Connects a structured OpenAPI definition file to a specific document tree, enabling API testing features.

### update_space
Changes the general metadata or settings of an entire documentation space.

### upload_file
Adds a file, like a diagram or image, into the Archbee storage area.

## Prompt Examples

**Prompt:** 
```
Search my Archbee docs for 'authentication flow'.
```

**Response:** 
```
I found 3 documents related to 'authentication flow'. The most relevant is 'OAuth2 Implementation Guide' (ID: abc123...). Would you like me to retrieve its content?
```

**Prompt:** 
```
Sync this OpenAPI YAML content to document tree 21charIDhere.
```

**Response:** 
```
Starting OpenAPI synchronization... The API definition has been successfully synced to the document tree. The 'Try It' feature is enabled as requested.
```

**Prompt:** 
```
Create a new document in Archbee with the title 'Onboarding' and content '# Welcome...'
```

**Response:** 
```
I've created the 'Onboarding' document. You can access it or update it further using the ID: doc_xyz789.
```

## Capabilities

### Create and Structure Spaces
You can build new documentation areas using create_space, update existing ones with update_space, clone structures via clone_space, or organize related spaces into groups using create_space_group.

### Manage Documents
The MCP lets you write new documents or revise old ones using create_update_doc; it can also pull existing content with get_doc and delete documents when they are retired.

### Import and Sync Content
You can quickly add formatted Markdown content using import_content, or automatically sync structured API data by running sync_openapi against an OpenAPI definition.

### Navigate and Search Knowledge
The agent searches across your entire organization's knowledge base with search_docs and retrieves specific details about API definitions using info_openapi.

### Maintain Documentation Integrity
You can export the whole organization data via export_organization, or even retrieve configuration settings by calling get_display_rules.

## Use Cases

### A PM needs to answer a niche customer question.
The PM asks their agent: 'Find all documentation related to billing rate changes.' The agent executes search_docs, retrieves the top three documents, and summarizes the necessary information from across different spaces.

### A developer updates a core endpoint.
Instead of manually updating code examples in Markdown, the dev tells their agent: 'Sync this new OpenAPI spec to the Payments guide.' The MCP runs sync_openapi, ensuring the documentation is immediately accurate and functional.

### A technical writer reorganizes old guides.
The writer asks the agent: 'I'm retiring the Legacy Auth space. Please delete that whole area, but first, create a group called Deprecated Guides to hold its contents.' They use delete_space followed by create_space_group.

### An onboarding flow needs multiple steps.
The agent is tasked with: 'Create a new space for Onboarding, clone the core setup guides into it, and add the latest markdown content about SSO.' This sequence uses create_space, clone_space, and import_content.

## Benefits

- Search everything instantly. Instead of manually checking five different sections, you can use search_docs to query your entire organization's knowledge base for technical answers in seconds.
- Keep API specs current without developer effort. By calling sync_openapi, you automatically connect structured OpenAPI files directly into documentation trees, enabling 'Try It' features right where users read the guide.
- Control content flow and structure. Need to organize your product guides? Use create_space_group or clone_space to maintain a consistent hierarchy without manual folder setup.
- Maintain version control simply. If you make changes in draft form, use merge_suggestion to pull those updates into the official document, keeping everything clean and traceable.
- Get content where it belongs. You can rapidly populate docs using import_content or upload files, eliminating the tedious copy-pasting process from Jira tickets or meeting notes.

## How It Works

The bottom line is that once it’s connected, you talk to your entire technical knowledge base using plain English.

1. First, subscribe to the Archbee MCP and provide your API key within Vinkius.
2. Second, tell your AI client exactly what you need done—for example, 'Sync this YAML file' or 'Create a new space called Billing Guides'.
3. The agent then executes the necessary commands directly against your documentation platform and reports the outcome.

## Frequently Asked Questions

**How do I search my docs with Archbee MCP?**
You use the search_docs tool to query all content across your entire organization. This lets you find specific technical details even if they are spread across multiple unconnected spaces.

**Can I update API documentation using Archbee MCP?**
Yes, absolutely. You use sync_openapi to connect an OpenAPI definition directly to a document tree. This keeps your guides accurate when the underlying APIs change.

**What if I need to delete a whole section of documentation?**
You can permanently wipe out an entire area using delete_space, or remove a group of related areas with delete_space_group. Be careful; this action is irreversible.

**Does Archbee MCP help me organize my guides?**
It does. You can use create_space_group to gather multiple, related spaces into one logical container for easier navigation and structure management.

**How do I add new content quickly using Archbee MCP?**
You use import_content when you have raw Markdown text. This tool inserts the provided content directly into your documentation structure without manual file uploads.