Rival Documentation

Rival Platform · Docs

The platform for AI agents - and the tools they call.

Configure an agent in 30 seconds. Ship a tool in any runtime. Publish to a marketplace. Run any of it with one HTTP request.

Build your first agent →

Quickstart - 5 minutes

Browse the marketplace ↗

Runs onPython 3.13 JavaScript Lua MCP Storm

Summarize the top three AI papers from this week.

YOU

On it - pulling from arXiv and Hacker News.

tool · arxiv_search · success

Top three: Tree-of-Thought v2, Mixture-of-Depths, Agentic Self-Verification.

Draft a launch email for our new pricing tier.

YOU

Pulling brand voice and recent launch templates.

tool · brand_voice · loaded

Draft ready - three variants attached. Want me to schedule send?

Find 5 fintech leads that raised $10M+ this quarter.

YOU

Querying enriched data and filtering by raise.

tool · search_companies · 412 hits

Top 5 ranked by fit - opening them in your CRM now.

Start here

Quickstart

Create your account, set up your organization, and unlock your welcome credits in five minutes.

Get started →

Build your first Agent

Configure an AI assistant with tools, knowledge, and a personality. Publish it to your org or the marketplace.

Build an agent →

Ship your first Tool

Write a serverless function in Python, JavaScript, or Lua. Test it in the browser. Run it via API.

Create a tool →

Run with one request

Every published tool and agent is callable over HTTP with your API key. No SDK required.

API reference →

Two ways to build

🤖 Agents

AI assistants that hold a conversation, reason, and call tools on your behalf.

Configure a persona, attach tools and knowledge, set guardrails, and let the agent figure out the rest. Publish versioned releases to the Agent Marketplace - others can adopt your agent into their org with a single click.

🛠️ Tools

Single-purpose, deterministic functions you can call from anywhere.

Write code in Python 3.13, JavaScript, or Lua. Test events in the browser. Publish versioned, immutable releases. Tools can be standalone, attached to agents, or composed via MCP and Storm.

What is a tool
Creating a tool
Building with RivalBot - AI tool builder
Versions & Publishing
The Tools Marketplace

What you get on Rival

Versioned by default

Every publish is immutable. Old versions stay callable. New versions ship without breaking anyone.

Marketplace built in

Publish privately to your org, or publicly to the marketplace. Free or paid, your choice.

Multi-runtime

Python 3.13, JavaScript, and Lua - pick the right tool for the job, per tool.

Pay only for what you run

Run Balance covers agent usage. Wallet covers direct tool execution. Top up any time.

Teams & roles

Invite teammates, assign roles, and group them into Teams with scoped permissions.

Built for AI

First-class MCP support. Agents can call tools, sub-agents, and OAuth connectors out of the box.

Run anything with one request

Every published tool and agent is callable over a simple HTTP endpoint.

curl 'https://cortexconnect.rival.io/api/v1/functions/{function_id}/{version}/invoke' \
  --header 'Authorization: <your_api_key>' \
  --header 'Content-Type: application/json' \
  --data '{"event": {"key": "value"}}'

import requests

res = requests.post(
    "https://cortexconnect.rival.io/api/v1/functions/{function_id}/{version}/invoke",
    headers={"Authorization": "<your_api_key>"},
    json={"event": {"key": "value"}},
)
print(res.json())

const res = await fetch(
  "https://cortexconnect.rival.io/api/v1/functions/{function_id}/{version}/invoke",
  {
    method: "POST",
    headers: {
      Authorization: "<your_api_key>",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ event: { key: "value" } }),
  }
);
console.log(await res.json());

Your API key lives in account settings. Function ID and version appear on every tool’s detail page.

Get going in four steps

Sign up and create your org

Sign up at cortexone.rival.io, name your organization, and verify your phone to unlock welcome credits.
Build something

Configure an agent in 30 seconds - or write a tool in your favorite runtime. Use RivalBot to generate the first draft for you.
Test in the browser

Run test events against your tool, or chat directly with your agent to validate behavior before sharing.
Publish and call

Choose visibility (Private, Org, Public), set a version, and you’re live. Call your tool or agent from anywhere with one HTTP request.

Pick your runtime

Python 3.13

Data processing, ML inference, and full library support via requirements.txt. Docker-based execution, fresh environment per call.

Python guide →

JavaScript

Lightweight logic, JSON transforms, and fast cold starts. Isolated V8 worker per execution. Synchronous-only - no async / await.

JavaScript guide →

Lua

Ultra-fast sandboxed scripting with minimal overhead. Perfect for transformations and lightweight policy code.

Lua guide →

MCP & Storm

Build MCP servers AI agents can call. Or use Storm for content tagging and classification.

MCP · Storm

Go deeper

Core Concepts Tools, runtimes, versions, execution environment, and how it all fits together.

Accounts & Organizations Roles, permissions, invitations, teams, and the referral program.

Billing & Balance Plans, Run Balance, Wallet, payouts, and monetizing what you publish.

Developer Guide Patterns, FAQs, and best practices from the Rival community.

Browse the marketplace ↗