Jinba Toolbox

Quickstart

Steps to create a tool and make it available from JinbaFlow

1. Create an Account

Visit toolbox.jinba.io and create an account using Google or Email.

2. Create an Organization

After logging in, create an Organization. You'll receive 500 free credits initially.

3. Create a ToolSet

Click "Tool Sets" → "New ToolSet" in the sidebar.

  • Name: Name for your tool group (e.g., my-tools)
  • Language: Python or TypeScript
  • Visibility: Private (organization only) or Public (external access)

4. Create a Tool

Click "New Tool" within your ToolSet and write your code.

Using Copilot: In the right panel, give instructions like "Create a tool that sends Slack notifications"

Writing manually:

from pydantic import BaseModel

class Input(BaseModel):
    message: str

class Output(BaseModel):
    success: bool

def run(input: Input) -> Output:
    # Implement your logic
    print(f"Received: {input.message}")
    return Output(success=True)

Tool Development Guide

5. Test

Enter Input in the test panel at the bottom and run with Cmd+Enter. Check logs and Output.

6. Publish

Go to "Versions" tab → "Publish New Version" to publish a version.

7. Use It

JinbaFlow / JinbaApp

Just click the "Connect" button in the ToolSet sidebar to integrate.

JinbaFlow Integration · MCP Integration

REST API

curl -X POST https://toolbox-api.jinba.io/v1/orgs/{orgId}/toolsets/{slug}/tools/{tool}/run \
  -H "Authorization: Bearer $API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"input": {"message": "Hello"}}'

Generate API keys from "API Keys" in the sidebar.

SDK

Next Steps

On this page