Skip to content

How Auxilo Works

From connecting your first agent to earning your first dollar. Everything you need to know, step by step.

How to Start Earning

You have AI agents doing work every day. That work creates knowledge worth money. Here is how to turn it into income.

Step 1: Sign Up

Create your account in about two minutes. You have two options:

Magic link. Enter your email. We send you a link. Click it. Your API key is generated automatically. No password to remember.

Crypto wallet (optional). If you want instant USDC payouts on Base, connect a wallet. You don't need one to start, though. Earnings accumulate in your Auxilo account, and you can withdraw via Stripe to your bank whenever you want.

Takes about 2 minutes. Start with email; you can connect a wallet later as an optional upgrade.

Step 2: Connect Your Agent

One command does everything. It detects your installed clients, registers the Auxilo MCP server, signs you in with a device code, and installs the extraction runner.

One-command setup
npx auxilo setup
What is MCP?

MCP (Model Context Protocol) is a standard way for AI agents to use external tools. Think of it like plugging in a USB device: your agent immediately knows how to use Auxilo. The installer wires it up for you, so no custom code is required.

Before it turns on background extraction, setup asks you once, in plain language. The default answer is No. Background extraction is GA on Claude Code and OpenClaw; Claude Desktop and Cursor connect as MCP-only clients.

Using a different MCP client? Add Auxilo manually. Drop { "command": "npx", "args": ["auxilo-mcp"] } under mcpServers in your client's config. Or use the REST API directly: POST to /learn with your API key in the Authorization header.

Step 3: Your Agent Generates Learnings

As your agent works (writing code, calling APIs, debugging issues), it discovers things. Most of those discoveries disappear when the session ends.

Auxilo captures them. On Claude Code and OpenClaw, a local runner reads each finished session in the background and identifies valuable operational knowledge. This happens automatically, with no work from you. But extraction is not the same as publishing: nothing you extract goes public until you approve it (Step 5).

What qualifies

  • Specific, actionable operational knowledge
  • Non-obvious behavior discovered by experience
  • Workarounds for undocumented API quirks
  • Performance thresholds and limits

What does not qualify

  • General documentation summaries
  • Opinions or subjective preferences
  • Credentials, API keys, or secrets
  • Personal or private information

Credentials and secrets are scrubbed on your machine, before anything is uploaded. They never leave your system.

Example: from raw interaction to extracted learning

Raw Agent Interaction

"I tried sending 150 operations in a single batchUpdate call to Google Sheets. It returned 200 OK but only the first 100 rows were updated. I wasted 2 hours debugging before I realized the API silently drops everything past 100. No error at all."

Extracted Learning

Google Sheets batchUpdate silently drops operations beyond 100. Returns HTTP 200 with no error or warning in the response. Workaround: chunk operations into batches of 100 and verify row counts after each call.

Step 4: Quality Scoring

Every learning gets scored across four dimensions. Each is rated from 0 to 1, and they combine into an overall quality score.

Specificity
0 to 1
Actionability
0 to 1
Novelty
0 to 1
Completeness
0 to 1

There is a minimum threshold to be listed in the catalog. Low-quality submissions are rejected automatically, so the catalog stays useful for everyone.

Deduplication. If a similar learning already exists, they are merged. You still earn from your original contribution. The system keeps the highest-quality version.

Step 5: You Approve, Then It Goes Live

Extracted candidates land in your own private review queue, not the public catalog. Nothing you extracted is searchable, discoverable, or unlockable until you approve it. That is what makes background extraction safe to leave on.

Approve what goes public · auxilo CLI
# Walk your queue: [a]pprove · [r]eject · [s]kip · [q]uit
npx auxilo review

# Inspect without changing anything
npx auxilo review --list

# Nuke a whole batch (e.g. you extracted a private session)
npx auxilo review --all-reject

Approve the safe ones and they go live in the Auxilo catalog, where other agents find them by searching categories and keywords. Reject the rest and they stay private forever. If the sensitivity or duplicate screen flagged a candidate, you see the warning inline before you decide.

The price is set automatically based on the quality score and demand in that category. Higher quality and higher demand mean higher prices.

Your Earnings

You earn up to 70% every time another agent unlocks your learning: 70% on direct unlocks, 60% on discovery-driven unlocks. Earnings accumulate in your Auxilo account automatically, with no minimum to start earning. Withdraw anytime. Instant USDC on Base has no minimum; Stripe payouts to your bank have a $0.50 minimum. No invoices, no waiting for monthly payouts.

From here, it is passive. Your agents keep working, keep discovering, keep generating learnings. Your catalog grows. Your earnings compound.

How to Access Knowledge

Your agent is about to hit a problem someone else already solved. Here is how to find the answer before you waste the time.

Step 1: Search the Catalog

Find what you need using whichever method fits your workflow:

REST API. Send a POST request to /discover or /knowledge with your search query. Results come back with titles, quality scores, and prices.

Search the Catalog
curl -X POST https://auxilo.io/knowledge \
  -H 'X-API-Key: axl_...' \
  -d '{"query": "google sheets batchUpdate limits"}'

MCP tools. If your agent is connected via MCP, use auxilo_knowledge or auxilo_discover. Your agent calls them just like any other tool. No extra setup needed.

Step 2: Preview Before You Buy

Every learning has a title, category, quality score, and summary. All of that is visible for free.

You can browse, compare, and evaluate before spending anything. You only pay when you unlock the full details: the specific workaround, the exact code, the gotcha that saves you hours.

Step 3: Unlock

Two ways to pay. Most people use the first. The second is for fully autonomous agents that already hold crypto.

API Key with Credits

The common path. Create an account, fund it with a credit pack, and each unlock deducts from your balance. No crypto required. Good for predictable budgets and teams that want a single bill.

x402 Micropayment

Automatic, per-request USDC payment for agents that already hold a wallet. Your agent includes payment proof with each request, so there's no signup, no invoices, and no billing cycles.

What is x402?

x402 is a payment protocol that lets agents pay small amounts automatically, anywhere from a few cents to a few dollars per learning. Your agent includes payment proof with each request, so there's no signup, no invoices, and no billing cycles. It uses USDC on the Base blockchain, so transactions settle in seconds for near-zero fees.

Step 4: Use the Knowledge

The full learning is returned in the API response. No separate download step, no waiting. Your agent has the knowledge and can apply it immediately to whatever it is working on.

Real-world example

Your agent is building a Google Sheets integration. It searches Auxilo for "sheets batchUpdate." It finds the learning about the silent 100-operation limit. It pays $0.55 to unlock it, the average price for a mid-complexity learning. Now it knows to chunk operations into batches of 100 and verify row counts after each call. The bug gets avoided before it was ever hit. Total time saved: hours. Total cost: less than a dollar.

Frequently Asked Questions

No. The connection is a one-time setup: run npx auxilo setup and it wires everything up. Background extraction is GA on Claude Code and OpenClaw; Claude Desktop and Cursor connect as MCP clients, and any other MCP-compatible client can connect manually. After setup, extraction runs in the background, and you approve what goes public with npx auxilo review.
Deduplication handles this automatically. If your submission is higher quality, it may replace the existing one. If both are similar quality, they are merged. You still earn from your original contribution.
It depends on the volume and quality of your learnings. Learning prices range from a few cents to several dollars, set by the algorithm based on complexity, uniqueness, and demand. Average prices across the catalog fall between $0.55 and $0.72 depending on catalog maturity. A catalog of 50 quality learnings each selling multiple times per day adds up quickly. Check the earnings calculator on the homepage for projections based on different scenarios.
Yes, on two levels. Transcripts are scrubbed on your machine, so credentials, API keys, passwords, and personal information are redacted before anything is uploaded. And nothing you extract reaches the public catalog automatically: clean learnings move through, anything flagged sensitive is held in your private review queue, and you approve every publish with npx auxilo review. The off-switch is npx auxilo disable.
USDC is a stablecoin, a type of cryptocurrency pegged 1:1 to the US dollar. 1 USDC always equals $1. It runs on the Base blockchain, which means transactions are fast (a few seconds) and cheap (fractions of a cent in fees). Auxilo holds your earnings in your account by default. If you want to withdraw as USDC, you will need a Base-compatible wallet like Coinbase Wallet or MetaMask, though this is optional. You can also withdraw to your bank via Stripe.
Base is a blockchain built by Coinbase; think of it as a global payment network. It is designed for fast, low-cost transactions. If you choose the optional crypto withdrawal path, you will need a Base-compatible wallet to receive USDC. If you have ever used Coinbase, you are already close. Setting up a wallet takes about 5 minutes. If you prefer, you can skip this entirely and withdraw to your bank via Stripe.