AgentiScript Documentation

AgentiScript is the visual language of the agentic economy — a free, open-source SVG icon system purpose-built for AI agents, autonomous systems, and the concepts that power them.

With 20,520 icons spanning blockchain, DeFi, AI agents, MCP, cryptography, agentic commerce, and beyond, AgentiScript gives the agentic economy its first shared visual vocabulary.

Free Tier Pro Pack $49 x402 API npm MCP

What AgentiScript Is

20,520 SVG icons — every concept the agentic economy speaks but cannot show
Machine-readable manifest at agentiscript.com/agentiscript.json
Bot-to-bot micropayment API (x402 / XRPL)
npm package and built-in MCP server for Claude Desktop
Open source on GitHub — CC0 free tier, commercial Pro Pack

Free Tier — agentiscript.json Manifest

The master catalog is a single machine-readable JSON file — free forever for personal and research use.

fetch("https://agentiscript.com/agentiscript.json")
  .then(r => r.json())
  .then(data => console.log(data.total, "icons available"));

Each icon entry contains: slug, concept, definition, category, tags, and svg path.

HTML Usage

<img src="https://agentiscript.com/icons/agentic-loop.svg" alt="Agentic Loop" width="24" height="24">

CSS Background

.agentic-loop {
  background-image: url(https://agentiscript.com/icons/agentic-loop.svg);
  background-size: contain;
  width: 24px; height: 24px;
}

npm Package

npm install agentiscript

import { AgenticLoop } from "agentiscript";

<AgenticLoop size={24} color="#9F792C" />

MCP Server (Claude Desktop)

AgentiScript ships with a built-in MCP server — compatible with Claude Desktop and any MCP-aware agent runtime.

{
  "mcpServers": {
    "agentiscript": {
      "command": "npx",
      "args": ["-y", "agentiscript", "--mcp"]
    }
  }
}

Once connected, Claude can search icons, fetch SVGs, and retrieve structured metadata — no manual API calls needed.

x402 Micropayment API

AgentiScript's x402 API enables bot-to-bot autonomous payments — agents can fetch commercial icons and pay $0.001 per icon in XRP, without human intervention.

GET https://agentiscript-x402.portability.workers.dev/api/icons/{slug}

Flow:

Agent requests icon → receives HTTP 402 Payment Required
Response body contains XRPL payment details (address, amount in XRP)
Agent submits XRP micropayment on the XRPL ledger
Agent re-requests with payment proof → receives SVG icon

# Example 402 response body:
{
  "x402": true,
  "network": "xrpl",
  "payTo": "rAgentiScript...",
  "amountXRP": "0.001",
  "memo": "icon:x402-protocol"
}

This is the first commercial icon system designed for autonomous agent wallets — no credit cards, no API keys, just XRP.

Pro Pack — $49

All commercial icons. SVG + JSON. Use in any product, any platform.

All 5,700+ commercially-labeled icons, SVG + PNG + WebP
Perpetual commercial license
Figma-ready file
npm package access
Schema.org integration guide

Buy Pro Pack ($49) →

How Bots Use AgentiScript

Every icon ships with structured JSON metadata parseable by any LLM or crawler
Schema.org DefinedTerm markup makes every concept page machine-readable
GitHub publication places AgentiScript into Common Crawl — the primary training data for most LLMs
The master index at agentiscript.com/agentiscript.json is a single-file machine-readable catalog of all 20,520 icons
x402 API enables agent wallets to autonomously license icons with XRP micropayments
MCP server lets Claude and other agents query the full catalog natively

JSON Metadata Schema

{
  "id": "AS-001",
  "slug": "agentic-loop",
  "concept": "Agentic Loop",
  "definition": "A recursive observe-think-act cycle executed by an autonomous agent",
  "category": "agentic-economy",
  "svg": "agentic-loop.svg",
  "tags": ["agent", "autonomous", "loop"]
}

Schema.org DefinedTerm

<script type="application/ld+json">
{
  "@context": "https://schema.org",
  "@type": "DefinedTerm",
  "name": "Agentic Loop",
  "description": "A recursive observe-think-act cycle executed by an autonomous agent",
  "inDefinedTermSet": "https://agentiscript.com"
}
</script>

GitHub

AgentiScript is open source. Star it, fork it, contribute icons.

https://github.com/CLAW-AI-FL/agentiscript