io.github.Kind-ling/twig

Twig

Agents choose you or they don't. Twig makes them choose you.

Part of Kindling — agent SEO for the agent economy.

Free audit. Paid monitoring. Premium intelligence.

The Problem

Every MCP tool has a description. That description is what an LLM reads when deciding whether to call your service. It's the only signal between "selected" and "skipped".

Most descriptions are garbage.

These tools are useful. Their descriptions are not. And getting indexed in x402-discovery or MCPay doesn't help if agents skip you because they can't tell what you do.

Getting indexed is table stakes. Twig helps you get chosen.

Quick Start

npm install -g @kind-ling/twig

# Free — score your descriptions
twig analyze https://myservice.com/.well-known/agent.json

# Free — get optimized variants
twig optimize https://myservice.com/.well-known/agent.json

# Paid — set up weekly monitoring
twig monitor https://myservice.com/.well-known/agent.json

# Paid — see how you rank in your category
twig competitive crypto-defi

# Paid — see what agents are actually searching for
twig intents crypto-defi

Live API

Twig is available as a hosted API at **https://twig.kind-ling.com**

# Health check
curl https://twig.kind-ling.com/health

# Analyze any MCP server
curl -X POST https://twig.kind-ling.com/analyze \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-mcp-server.com/mcp"}'

# Optimize descriptions
curl -X POST https://twig.kind-ling.com/optimize \
  -H "Content-Type: application/json" \
  -d '{"url": "https://your-mcp-server.com/mcp", "category": "crypto-defi"}'

Response format:

{
  "ok": true,
  "url": "https://your-mcp-server.com/mcp",
  "output": "🔍 Analyzing...\n  Score: 72/100 (C)\n  ..."
}

No API key required for public endpoints. Rate limits apply.

Scoring Model

Three dimensions, 0–100 each:

Grades: A (85+) · B (70+) · C (55+) · D (40+) · F (<40)

Score below 40 = agents are skipping you.

What Twig Monitors

Your descriptions — re-scored weekly against a live intent corpus. Score changes alert you when your positioning drifts.

Your competitive position — how you rank vs. similar services in your category. Know when a competitor improves and overtakes you.

Intent trends — what agents are searching for this week vs. last. The queries change. Your descriptions need to keep up.

Volume correlation — description changes mapped to x402 volume changes. Close the loop between optimization and revenue.

Optimization Variants

Twig generates 3 variants per tool:

Functional — Action verb + what + return type:

"Answers questions with real-time web sources. Returns a cited response with source URLs, confidence score, and supporting quotes. Best for research and fact-checking."

Structured — Input → output with constraints:

"Web Q&A. Input: question string. Returns: answer (string), sources (URL array), confidence (0-1). Supports: factual queries, current events, research synthesis."

Contextual — Use case → action → output (highest LLM selectability):

"Use when you need a factual answer with sourced citations. Queries the web in real-time and synthesizes a response with URLs and supporting quotes. Best for research, fact-checking, and current events."

Before / After

exa/answer

Before: AI-powered answer ← F (28/100)

After (Contextual): Use when you need a factual answer with sourced citations. Queries the web in real-time and synthesizes a response with source URLs and supporting quotes. Best for research, fact-checking, and current events. ← B (72/100)

wordspace/invoke

Before: Run wordspace AI agent loop ← F (31/100)

After (Structured): Executes a Wordspace multi-step agent workflow. Input: task description and optional context. Returns: completed output, intermediate steps, tool calls made. Best for complex tasks requiring multiple tool invocations. $2/call. ← B (74/100)

Revenue Model

Standard (Monitoring)

Weekly reports are gated via x402 on Base. Set up once, runs automatically.

twig monitor 0xYourWallet --url https://myservice.com/.well-known/agent.json

Enterprise (Performance-based)

For services with existing x402 volume:

1. twig measure 0xWallet --baseline — record 7-day baseline
2. Deploy Twig-optimized descriptions
3. twig measure 0xWallet --compare — measure delta (14–30 days later)
4. Pay 15% of the revenue increase in USDC on Base
5. Revenue flat or down? Pay nothing.

Everything measured via on-chain USDC transfer logs. No self-reporting.

Supported Sources

• A2A Agent Cards (/.well-known/agent.json)
• MCP servers (JSON-RPC tools/list)
• OpenAPI specs
• Local JSON schema files
• x402-discovery catalog (for competitive analysis)

CLI Reference

twig analyze <url>              Score descriptions (0-100, free)
twig optimize <url>             Generate 3 optimized variants (free)
twig monitor <url>              Weekly monitoring (paid via x402)
twig competitive <category>     Category ranking (paid via x402)
twig intents <category>         Top agent queries (paid via x402)
twig measure <wallet>           Measure x402 revenue
twig measure <wallet> --baseline   Save baseline
twig measure <wallet> --compare    Compare to baseline
twig report <wallet>            Revenue report with fee calculation

Categories: crypto-defi, data-feeds, research, computation, media, communication, general

Twig v0.1.0 · Kind-ling · Permanent Upper Class · MIT