Neuronum Docs | Create A Tool

Create A Tool

About Neuronum Tools

Neuronum Tools are MCP-compliant (Model Context Protocol ) plugins that extend your Agent's (ceLL Zero) functionality, enabling it to interact with external data sources and systems.

Requirements

Python >= 3.8

Connect To Neuronum

Installation (optional but recommended: create a virtual environment)

Bash

pip install neuronum

Create your Cell:

Bash

neuronum create-cell

or

Connect an existing Cell:

Bash

neuronum connect-cell

Initialize a Tool

Bash

neuronum init-tool

You will be prompted to enter a tool name and description (e.g., "Test Tool" and "A simple test tool"). This will create a new folder named using the format: Tool Name_ToolID (e.g., Test Tool_019ac60e-cccc-7af5-b087-f6fcf1ba1299)

This folder will contain 2 files:

tool.config - Configuration and metadata for your tool
tool.py - Your Tool/MCP server implementation

Example tool.config:

Config

{
  "tool_meta": {
    "tool_id": "019ac60e-cccc-7af5-b087-f6fcf1ba1299",
    "version": "1.0.0",
    "name": "Test Tool",
    "description": "A simple test tool",
    "audience": "private",
    "logo": "https://neuronum.net/static/logo_new.png"
  },
  "legals": {
    "terms": "https://url_to_your/terms",
    "privacy_policy": "https://url_to_your/privacy_policy"
  },
  "requirements": [],
  "variables": []
}

Example tool.py:

Python

"""
Simple Standardized MCP Server Example
Demonstrates the official MCP protocol with stdio transport.
"""

from mcp.server.fastmcp import FastMCP

# Create server instance
mcp = FastMCP("simple-example")


@mcp.tool()
def echo(message: str) -> str:
    """Echo back a message

    Args:
        message: Message to echo back

    Returns:
        The echoed message
    """
    return f"Echo: {message}"


@mcp.tool()
def add(a: int, b: int) -> int:
    """Add two numbers

    Args:
        a: First number
        b: Second number

    Returns:
        Sum of a and b
    """
    return a + b


if __name__ == "__main__":
    mcp.run()

Update a Tool

After modifying your tool.config or tool.py files, submit the updates using:

Bash

cd Test Tool_...

neuronum update-tool

Delete a Tool

To remove a tool from Neuronum:

Bash

neuronum delete-tool