onetool-mcp

Overview

OneTool is an innovative MCP server that addresses the problem of excessive token consumption when using multiple MCP servers. By providing over 100 tools through a Python API interface, it reduces token usage from approximately 150,000 tokens to just 2,000 tokens - a cost saving of 98.7%. The server includes diverse tool packs for web search, AWS operations, database interactions, file operations, diagram creation, document conversion, and more. It also features special tools like image vision, smart context storage, and text compaction.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

• brave.search

  Web search using the Brave search engine

  Try:Search for latest AI newsTry:Find information about climate change solutions
• db.query

  Execute SQL queries on databases

  Try:Query the customers database for all users registered in 2023Try:Get the top 10 products by sales revenue
• file.read

  Read contents of files

  Try:Read the contents of the README.md fileTry:Show me the code in src/main.py
• excel.read

  Read data from Excel files

  Try:Read the sales data from Q4.xlsxTry:Get all entries from the customer spreadsheet
• ot_image.load

  Load and analyze images using vision AI

  Try:Analyze this chart image and extract the dataTry:Describe what's in this screenshot
• whiteboard.draw

  Create diagrams on an Excalidraw whiteboard

  Try:Draw a system architecture diagramTry:Create a flowchart for user authentication
• convert.pdf_to_md

  Convert PDF documents to Markdown

  Try:Convert the research paper PDF to MarkdownTry:Transform this document into readable text format
• aws.whoami

  Check current AWS identity and permissions

  Try:Show me my current AWS user identityTry:What permissions do I have in this AWS account?
• diagram.create

  Create Mermaid diagrams

  Try:Create a sequence diagram for user registrationTry:Generate a flowchart for the approval process
• ot_context.search

  Search in the smart context store

  Try:Search for previous results about database optimizationTry:Find information about the project architecture
• tavily.search

  AI-native search with Tavily

  Try:Research the latest developments in quantum computingTry:Find information about sustainable building materials
• webfetch.fetch

  Fetch content from web pages

  Try:Fetch the content from example.com/aboutTry:Get the HTML from the product page

Comparable tools

Installation

uv tool install 'onetool-mcp[all]'   # everything
onetool init --config ~/.onetool

claude mcp add onetool -- onetool --config ~/.onetool/onetool.yaml --secrets ~/.onetool/secrets.yaml

{
  "mcpServers": {
    "onetool": {
      "command": "onetool",
      "args": ["--config", "/Users/yourname/.onetool/onetool.yaml", "--secrets", "/Users/yourname/.onetool/secrets.yaml"]
    }
  }
}

FAQ

How does OneTool reduce token usage?

Instead of sending tool definitions for each MCP server (3K-30K tokens per server), OneTool provides a Python API where agents write code directly, reducing token usage by 96% regardless of how many tools are used.

Can I use existing MCP servers with OneTool?

Yes, OneTool includes an MCP Server Proxy feature that allows you to wrap existing MCP servers without the tool tax, calling them explicitly via Python code.

What security features does OneTool provide?

OneTool includes AST validation, path boundaries, output sanitization, and encrypted secrets management using age-encrypted yaml files backed by your OS keychain.

Compare onetool-mcp with