Warps is an open-source protocol for defining executable actions that bridge AI agents to any application, API, or blockchain. It turns conversations into real-world execution across web services and decentralized networks.
A Warp is a declarative JSON object that describes a "skill" for an AI agent. Instead of writing custom integration code for every API, chain, or wallet, you define:
- Action Protocol: Standardized format for REST API requests, smart contract calls, and asset transfers.
- Dynamic Input Collection: How the AI should prompt the user or extract data from context.
- Universal Execution: Support for standard Web2 APIs alongside Ethereum, Solana, Sui, MultiversX, Base, and other chains.
- Agent Native: Designed to be natively understood by LLMs like GPT-4, Claude 3.5, and specialized JoAi agents.
Warps are designed to serve as the portable schema for Model Context Protocol (MCP) tools.
By standardizing the definition of actions, inputs, and outputs in JSON, Warps allow generic runners to dynamically expose your API to AI agents. You define the interface once, and it becomes compatible with the entire MCP ecosystem.
This repository is the central registry for Warp definitions. Developers are invited to contribute new Warps to expand the capabilities of the ecosystem.
Each Warp can have an associated ChatApp that provides a rich, interactive experience within the chat interface. These are built as standalone HTML files.
Place your ChatApp source code (index.tsx, styles.css) directly alongside the warp.json in the specific warp directory:
warps/<brand>/<warp-name>/
To build all ChatApps in the repository:
npm install
npm run buildTo build a specific app:
node ui/build.js <brand>/<warp-name>
# Example: node ui/build.js multiversx/account-infoThe build process will:
- Compile the React code into a standalone HTML file (
chatapp.dist.html). - Update the
warp.jsonfile'suifield to point to the hosted version of this artifact.
To start a local development server for a specific ChatApp:
npm run dev <brand>/<warp-name>
# Example: npm run dev multiversx/account-infoThis will start a Vite server at http://localhost:5173 with Hot Module Replacement (HMR).
To run tests for the ChatApps:
npm testWe provide skills that teach your AI assistant (Cursor, Claude) how to write Warps for you:
npx skills add JoAiHQ/skillsAsk your assistant: "Create a Warp that allows users to create a new issue on Linear."
Validate your warp definition using the playground:
node playground/inspect.js warps/my-project/my-action.jsonContributing to this repository automatically plugs your integrations into the JoAi Cloud.
We handle the infrastructure so you can focus on the capabilities. Once your Warp is merged:
- Hosted Dynamic MCP: We provide the generic MCP server execution. Your Warps instantly become live tools that users can connect to (e.g., in Claude Desktop) without running their own servers.
- No-Code Experience: Users can use your tools with zero friction—no local setup or maintenance required.
- Instant Deployment: Your definitions and UIs are automatically hosted on our global CDN.
- Universal Reach: Your actions become instantly discoverable and executable by any agent in the JoAi ecosystem.
It's the fastest way to get your service into the hands of AI users.
- Fork this repository.
- Add your Warp JSON to the
warps/directory. - Include any necessary ABIs in the
abis/subdirectory and brand metadata inbrand.tswithin your warp's brand folder. - Submit a Pull Request.
Once merged, your Warp will be automatically indexed and deployed to the JoAi Managed Platform and other supported clients.
- Documentation: https://docs.joai.ai/warps
- Visual Editor: usewarp.to/create
- Community: Telegram