torna

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.