neuron-tool

Neuron AI Tool

This skill helps you create custom tools, toolkits, and MCP integrations for Neuron AI agents.

Core Concepts

Tools give agents the ability to:

• Execute actions (API calls, database queries, file operations)
• Retrieve information (web search, data lookup)
• Interact with external systems

Every tool has:

• Name: Unique identifier
• Description: Explains what the tool does (critical for LLM)
• Properties: Input parameters with types and descriptions
• __invoke(): The actual logic to run — returns a ToolOutput (default), or a plain string/array

Creating Custom Tools

Method 1: Extend Tool Class with __invoke

The cleanest approach for complex tools:

use NeuronAI\Tools\Tool;
use NeuronAI\Tools\ToolOutput;
use NeuronAI\Tools\ToolProperty;
use NeuronAI\Tools\PropertyType;

class WeatherTool extends Tool
{
    protected string $name = 'get_weather';

    protected ?string $description = 'Get the current weather for a location. Returns temperature, conditions, and humidity.';

    protected function properties(): array
    {
        return [
            ToolProperty::make(
                name: 'location',
                type: PropertyType::STRING,
                description: 'The city and country, e.g., "Paris, France"',
                required: true
            ),
            ToolProperty::make(
                name: 'units',
                type: PropertyType::STRING,
                description: 'Temperature units: "celsius" or "fahrenheit"',
                required: false,
                enum: ['celsius', 'fahrenheit']
            ),
        ];
    }

    public function __invoke(string $location, ?string $units = 'celsius'): ToolOutput
    {
        // Your API call or logic here
        $weatherData = $this->fetchWeather($location, $units);

        return ToolOutput::text(json_encode($weatherData));
    }

    private function fetchWeather(string $location, string $units): array
    {
        // Implementation...
        return [
            'location' => $location,
            'temperature' => 22,
            'units' => $units,
            'conditions' => 'sunny',
        ];
    }
}