# Tettra MCP

> Tettra MCP connects your internal wiki documentation directly to your AI agent. Need an API spec or a team policy? Your agent searches, reads, and even drafts new content from across your company's knowledge base, all without you leaving your IDE. It handles full-text searching, page retrieval, and publishing updates instantly.

## Overview
- **Category:** brain-trust
- **Price:** Free
- **Tags:** wiki, internal-documentation, search, knowledge-base, team-collaboration, onboarding

## Description

Stop switching tabs just to look up internal details. This MCP connects Tettra, your company's central documentation hub, right into your developer workflow. Instead of clicking through multiple categories or running separate searches, you talk to your agent and it handles the whole process. You can ask complex questions and get instant answers by searching across all existing pages. Need to contribute? Your agent drafts new wiki content or updates old guides on demand. This means keeping your team's knowledge current is part of your daily coding routine.

When you connect this MCP through Vinkius, you give your AI client a direct line into your organizational memory. It’s more than just searching; it lets your agent publish new documentation and even manage the Q&A board, making sure your team always has accurate information at their fingertips.

## Tools

### create_wiki_page
Creates a brand-new wiki page within a specific category using a title, content, and category ID.

### create_qa_question
Posts a new question directly into the Tettra Q&A system for team members to answer.

### get_category_details
Retrieves specific metadata and details about a designated Tettra category.

### get_page_content
Fetches the full title, markdown, and HTML body content of an existing Tettra page.

### list_categories
Retrieves a list of all top-level categories available across the entire Tettra wiki.

### list_pages_in_category
Returns a list of all specific wiki pages that belong under one selected category.

### list_qa_questions
Retrieves a comprehensive list of all questions currently posted in the Tettra Q&A system.

### list_subcategories
Lists all subfolders or subsections nested under a specific parent category.

### search_pages
Performs a full-text search across the entire Tettra wiki and returns up to five matching pages.

### suggest_new_page
Automatically suggests that a new wiki page needs to be created for the team's review.

### update_wiki_page
Modifies the title or content of an existing Tettra page using its unique ID and new information.

### verify_wiki_page
Marks a specific wiki page as verified, confirming it is up-to-date and accurate.

## Prompt Examples

**Prompt:** 
```
Search the wiki for 'Database Migration Checklist'.
```

**Response:** 
```
I found 1 relevant page in the wiki:
- **Database Migration Checklist** (ID: 1042) in the 'Engineering' category.
Would you like me to fetch the full markdown content of this guide?
```

**Prompt:** 
```
Create a new wiki page in the 'Support' category explaining how to handle refund requests.
```

**Response:** 
```
Successfully published page **Refund Handling Procedure** (ID: 4055) to the Support category (ID: 12)!
The content has been formatted with step-by-step markdown. Your team can now search for it natively on Tettra.
```

**Prompt:** 
```
Mark page ID 883 as verified and up to date.
```

**Response:** 
```
The page 'Deployment Keys Matrix' (ID 883) has been officially verified! ✅
The system will log that it was verified today, maintaining trust in your knowledge base.
```

## Capabilities

### Search across all wiki pages
Find instant answers by performing a full-text search across every page in your Tettra knowledge base.

### Retrieve full documentation content
Read the complete text, including markdown and HTML, for any specific technical guide or policy page inside your chat window.

### Create new wiki pages
Draft and publish brand-new internal articles in a specified category with simple prompts.

### Update existing documentation
Modify the title or content of an old page using its ID, keeping your guides current.

### Manage Q&A records
List existing questions or post new ones directly to the team's internal question board.

## Use Cases

### Debugging an unknown API requirement
An engineer needs to know the exact format for a specific payload. They ask their agent, and it uses search_pages and get_page_content to pull up the relevant section from the 'API Specs' wiki page, providing the necessary data instantly.

### Creating an SOP after a process change
An operations lead finishes updating a workflow. They prompt their agent to create_wiki_page in the 'Support' category and draft the new Standard Operating Procedure, which is then immediately visible on Tettra.

### Identifying necessary policy updates
A product manager notices inconsistencies across documentation. They ask their agent to list_pages_in_category for 'Legal' and identify pages that haven't been updated in six months, flagging them for review.

### Addressing unanswered team questions
A developer runs into a recurring roadblock. They use the agent to list_qa_questions, see that the question is still open, and then use create_qa_question to formally post it to get an official answer.

## Benefits

- Instant Answers: Use the search_pages tool to find specific answers across all documentation without running manual keyword searches or browsing folder trees.
- Zero Context Switching: Your agent reads full page content via get_page_content, providing technical guides and policies right inside your chat window while you code.
- Documentation Maintenance: Easily publish new knowledge using create_wiki_page. This keeps internal processes (like SOPs) immediately available to every team member.
- Knowledge Governance: Use verify_wiki_page to mark critical documents as up-to-date, building trust and reliability in your company's source of truth.
- Systematic Q&A Management: Instead of checking a separate board, list_qa_questions lets you see unanswered questions or post new ones right from your workflow.

## How It Works

The bottom line is you use your natural language prompts to get your AI agent to manage and query all aspects of your company knowledge base.

1. Subscribe to this MCP and enter your Tettra Team ID and API Key (requires a Professional or Scaling plan).
2. Instruct your AI client to perform an action, like listing categories or searching for a term.
3. The agent executes the request against Tettra, returning formatted data—whether it's page content, a list of questions, or confirmation that a new article was published.

## Frequently Asked Questions

**How do I search for specific guides using Tettra MCP?**
You use the agent to run search_pages. You just give it a topic—like 'Database Migration Checklist'—and the agent returns links and titles from your knowledge base.

**Can I publish new wiki pages using Tettra MCP?**
Yes, you can use create_wiki_page. You provide a title, content, and category ID, and the agent publishes the article to Tettra for your team.

**What if I update an old page? Do I need multiple steps?**
No. If you know the page ID, you use update_wiki_page with the new content. To make sure everyone trusts it afterward, run verify_wiki_page.

**How does Tettra MCP help with Q&A management?**
You can list_qa_questions to see unanswered topics or create_qa_question to formally submit a new question for the team to address.

**Does this connector work in VS Code? (Tettra MCP)**
Yes, it works across any MCP-compatible client. You connect your preferred AI agent inside Cursor or VS Code and use Tettra's tools just as normal.