JoAi Warps

What it does

JoAi Warps is an open-source protocol and registry for defining executable AI agent actions called "Warps." Each Warp is a declarative JSON object that describes how an AI agent should interact with an external service — from a REST API call to a smart contract transaction on Ethereum, Solana, Sui, MultiversX, or Base. Warps serve as a portable schema for MCP tools: define an action once, and it becomes instantly available to any MCP-compatible AI client without writing custom integration code.

Key features

• Universal action format — standardized JSON schema covering REST requests, blockchain contract calls, and asset transfers
• Dynamic MCP server — JoAi hosts the execution layer; Warp definitions auto-deploy as live MCP tools connectable from Claude Desktop and other clients
• ChatApp support — each Warp can include a React-based interactive UI (chatapp.dist.html) rendered inside the chat interface
• Multi-chain support — Ethereum, Solana, Sui, MultiversX, Base, and other EVM-compatible chains
• AI-native authoring — includes agent skills for Cursor and Claude to generate Warp definitions from natural language prompts
• Global CDN deployment — merged Warps are automatically hosted and indexed across the JoAi ecosystem

Installation

Add the AI authoring skills to your agent:

npx skills add JoAiHQ/skills

Connect to the hosted JoAi MCP server in Claude Desktop:

{
  "mcpServers": {
    "joai-warps": {
      "url": "https://mcp.joai.ai"
    }
  }
}

Run locally and inspect a Warp definition:

npm install
node playground/inspect.js warps/my-project/my-action.json

Supported hosts

JoAi provides a hosted MCP endpoint compatible with Claude Desktop and any MCP client that supports HTTP transport.