home / mcp / torna mcp server

torna MCP Server

Exposes Torna API documentation as MCP tools, resources, and prompts for AI assistants to query, search, and generate API definitions.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "chenqi146-torna-mcp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "PORT": "3000",
        "MCP_URL": "http://localhost:3000",
        "password": "your_torna_password",
        "username": "your_torna_username",
        "projectid": "your_project_id",
        "torna-base-url": "http://your-torna-server:7700"
      }
    }
  }
}

You can run torna-mcp to bridge Torna API documentation with AI assistants, letting you search, query, and generate API details and curl commands through natural language. It supports quick setup, zero-config authentication, and project switching, enabling seamless access to Torna docs from your AI workflow.

How to use

Install and run torna-mcp, then connect your MCP client to the provided MCP URL. Use the built-in tools to search APIs, fetch API details, generate curl commands, switch projects, and view project metadata. You can perform actions like: find APIs by a natural language requirement, search by keyword, get detailed definitions for multiple APIs in parallel, switch between Torna projects, and generate ready-to-use curl commands for API endpoints.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

# Install dependencies and build the server
git clone https://github.com/chenqi146/torna-mcp.git
cd torna-mcp
npm install
npm run build

# Run the server locally
npm start
# Server runs on http://localhost:3000

# Or build and run with Docker
# docker build -t torna-mcp .
# docker run -p 3000:3000 torna-mcp

Additional sections

Configuration, usage, and security notes are provided below to help you integrate torna-mcp into your workflow and keep credentials secure.

Security and authentication are designed to be zero-config for convenience. Credentials are cached per connection, so you don’t need to re-enter them for repeated requests within the same session.

Available tools

torna-project-info

Get current session info including username, project, token status, and document count.

torna-search-docs

Search APIs by keyword or natural language requirement and return matching API definitions.

torna-get-doc-detail

Fetch API detail for one or more docs, supporting concurrent/batch requests.

torna-list-projects

List all accessible Torna spaces/projects from the current session.

torna-select-project

Switch the active Torna project for subsequent operations.

torna-find-apis-by-need

Find APIs that satisfy a natural language requirement, auto-fetching details for smaller project sets to improve matching.

torna-generate-request

Generate a ready-to-use curl command from an API definition.