You are equipped with a Model Context Protocol (MCP) server that exposes Theneo’s API documentation platform to AI assistants. This server lets you create, update, and publish API docs automatically, enabling AI-driven workflows, CI/CD automation, and developer productivity tools with natural language commands.

How to use

Interact with the MCP server using an MCP-compatible AI assistant. You can reference workspaces and projects by name, not IDs, and perform end-to-end documentation tasks such as listing workspaces, creating projects from OpenAPI specs, importing updates, generating AI descriptions, previewing editors, and publishing documentation. You can combine natural language prompts with explicit tool calls to control flow and timing, for example by creating a project, waiting for AI generation to finish, then exporting or publishing.

How to install

Prerequisites: Node.js (for building and running the MCP server locally) and a modern shell. You will install a local MCP CLI, or run the server via Docker. Follow the concrete steps below to get started.

# Global installation (recommended for quick start)
npm install -g theneo-mcp

# Verify installation
theneo-mcp --version

Additional setup steps

Docker provides a ready-to-run option that accepts an API key for authentication. You can pull the latest image and run it with your key in the environment.

# Pull and run with API key
docker pull theneo/theneo-mcp:latest

docker run -it --rm \
  -e THENEO_API_KEY=your_api_key \
  theneo/theneo-mcp:latest

Usage with development and customization

If you are developing locally, you can clone the project, install dependencies, and build before running the server. The typical flow is to install dependencies, build, and then start the MCP server.

git clone https://github.com/atombreak/theneo-mcp.git
cd theneo-mcp
npm install
npm run build

# Start during development (example)
npx theneo-mcp server

Note: You may run the server with an API key as an environment variable when you start it in development or production environments. Replace your_api_key with your actual key.

## Configuration and environment

Configure authentication and environment settings to control how the MCP server operates and how it connects to Theneo services.

OS keychain (recommended for local dev)

theneo-mcp creds save --profile default --apiKey YOUR_API_KEY

Environment variable (alternative)

export THENEO_API_KEY=YOUR_API_KEY

## Available tools and workflows (high level)

Use the MCP client through your AI assistant to manage projects, workspaces, versions, AI generation, previews, and exports. You can list workspaces, create projects from OpenAPI specs, import updates, publish versions, and export documentation. Tools can be driven by natural language prompts or explicit tool calls.

## Available tools

### theneo\_list\_workspaces

List all workspaces accessible to your account. Provides a view of the workspaces you can interact with.

### theneo\_list\_projects

List all projects in a workspace or across workspaces. You can filter by workspace by ID, key, or name.

### theneo\_create\_project

Create a new API documentation project from an OpenAPI/Swagger file, URL, or raw spec, with optional AI description generation and publishing.

### theneo\_import\_project\_document

Import or update API documentation into an existing project from a file, URL, or raw spec, with merge or overwrite options.

### theneo\_publish\_project

Publish a project to make it live, optionally specifying a version to publish.

### theneo\_preview\_link

Get the editor preview URL for a project to review the docs in the editor.

### theneo\_wait\_for\_generation

Wait for AI-generated descriptions to complete for a project.

### theneo\_get\_generation\_status

Check the progress and status of AI description generation for a project.

### theneo\_delete\_project

Permanently delete a project and all its associated data.

### theneo\_list\_project\_versions

List all versions of a specific project.

### theneo\_create\_project\_version

Create a new version of a project, possibly copying from a previous version.

### theneo\_delete\_project\_version

Delete a specific project version.

### theneo\_add\_subscriber\_to\_version

Add an email subscriber to receive updates for a specific project version.

### theneo\_export\_project

Export a project's documentation, optionally as OpenAPI, with various options.

### theneo\_list\_postman\_collections

List all Postman collections available with a given Postman API key.