What an AI Tool contains
An AI Tool is a versioned ZIP package containing tool.json, a runnable entry point, and optionally a README. AI Connect loads enabled AI Tools and makes their tools available to connected MCP clients.
You can create and test AI Tools locally without a cloud account. Sign in only when you want to upload and publish.
SDK setup
The JavaScript SDK is @syraio/ai-connect on npm. The Python SDK is ai-connect on PyPI and imports as ai_connect.
Public SDK download links are not listed on this website yet. The examples below show the tool API. Follow the installation instructions supplied with an available SDK release before running them.
JavaScript and TypeScript
import { createAiTools } from '@syraio/ai-connect';
const myTools = createAiTools({ name: 'my-tools', version: '1.0.0' });
myTools.add_tool('hello', 'Return a greeting.', () => {
return 'Hello from my tool!';
});
export default myTools;
The JavaScript project generator is @syraio/create-ai-connect. In a generated project, edit your tool source and run:
npm run package
The project script builds the JavaScript entry point and creates the AI Tool ZIP. The SDK helper command is ai-connect-sdk; the server command is ai-connect.
Python
from ai_connect import create_ai_tools
myTools = create_ai_tools(name="my-tools", version="1.0.0")
myTools.add_tool("hello", "Return a greeting.", lambda args: "Hello!")
After installing the Python SDK, create a starter and package it with:
python -m ai_connect create my-tools
python -m ai_connect package my-tools
Python AI Tool packages include dependencies. Build for the operating system, architecture, and Python minor version your users will run.
Test locally
Install your ZIP through AI Tools / Install from ZIP in AI Connect. Select its runtime, enable the AI Tool, and start MCP tools. Connect your AI client and verify tool discovery and a real tool call.
This workflow does not require a cloud account.
Document and version your AI Tool
Include a UTF-8 README.md describing what the tools do, how to configure them, and their runtime and platform requirements. The AI Tool page displays the README from the selected release.
Give each release a new version. Keep the AI Tool ID stable when adding a release to an existing listing. Existing versions cannot be overwritten.
Publish when ready
Sign in to your account and upload the ZIP. New listings start as private drafts. Review the name, description, and README, then publish the listing.
Uploading another version to an already published listing makes that release publicly available. Public visitors can browse and download without an account.