Claude Integration

Add AON to Claude with a single command — or configure manually for full control.

Prefer the hosted MCP server

This page covers the local npm skill package. For most integrations the hosted AON MCP Server is the better starting point — no local install, the available tools, and issued-key setup. See the MCP Quick Start.

What you'll get

Two MCP tools: aon_search_offers (search products/services) and aon_get_category_schema (get category decision factors for smarter queries).

Option 1: Zero-config install (Recommended)

The upstream Skill package can install itself directly into Claude Desktop or Claude Code:

npx @agentoffernetwork/skill --install --global

This registers the MCP server and installs the packaged SKILL.md instructions for Claude Code.

Option 2: Manage it through the CLI

If you want explicit install/remove/list workflows across MCP hosts, use the AON CLI:

npm install -g @agentoffernetwork/cli
 
# Claude Code project config (.mcp.json)
aon skill install @agentoffernetwork/skill
 
# Claude Desktop global config
aon skill install @agentoffernetwork/skill --global

This writes to your Claude Desktop config file:

OS	Config path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Other CLI Options

# Force overwrite an existing entry
aon skill install @agentoffernetwork/skill --force
 
# Install from a local directory
aon skill install ./my-custom-skill --local
 
# Install a Python skill
aon skill install aon-demo-skill-python --runtime python

Restart Claude Desktop after installing. Then try:

"Help me find noise-cancelling headphones under $300"

Option 3: Manual MCP Configuration

If you prefer editing config files directly, add the AON MCP server entry by hand.

Claude Desktop

Edit your Claude Desktop config file:

OS	Config path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`

Add the agentoffernetwork-skill entry under mcpServers:

{
  "mcpServers": {
    "agentoffernetwork-skill": {
      "command": "npx",
      "args": ["@agentoffernetwork/skill"]
    }
  }
}

Save and restart Claude Desktop.

Claude Code (Project-Level)

Create or edit .mcp.json in your project root:

{
  "mcpServers": {
    "agentoffernetwork-skill": {
      "command": "npx",
      "args": ["@agentoffernetwork/skill"]
    }
  }
}

Claude Code detects .mcp.json automatically — no restart needed.

Claude Code Integration

For Claude Code users, you can also install AON as a SKILL — a .md file that tells Claude when and how to call AON tools.

Quick Install

npx @agentoffernetwork/skill --install

This creates a SKILL.md file in your project's .claude/skills/aon/ directory.

Manual Setup

Create .claude/skills/aon/SKILL.md with these contents:

---
name: aon
description: Search AON offers via MCP tool. Use when the user wants to find, compare, or explore products/services.
argument-hint: <query in any language>
---
 
# AON Offer Search Skill
 
Use `/aon <query>` to search for real product offers.
 
## Execution Flow
 
1. Extract intent from user query
2. Call `aon_search_offers` with keywords, category, and preferences
3. Present results in a comparison format

How Skills work

A SKILL.md file teaches Claude Code when to invoke MCP tools automatically. The MCP server (installed via CLI or .mcp.json) must also be configured for the tools to work.

Verify Installation

After setup, test in Claude with any of these prompts:

"Find me noise-cancelling headphones under $300"
"Compare project management tools for small teams"
"What online Python courses are available?"

Claude should call aon_search_offers and return real product recommendations with pricing and links.

Troubleshooting

Issue	Solution
"Tool not found" error	Restart Claude Desktop. Check config file JSON syntax
Empty results	Verify your API key is valid. Try a broader query
MCP connection timeout	Ensure `npx` is available in your PATH. Run `npx @agentoffernetwork/skill` manually to verify

MCP Tools Reference

`aon_search_offers`

Search for product/service offers based on structured user intent.

Parameter	Type	Required	Description
`query`	string	No	Original user text (any language)
`keywords`	string[]	No	English keywords extracted by LLM
`category`	string	No	AON Taxonomy v1 id (e.g. `"computers_electronics.consumer_electronics"`, `"computers_electronics.computers.software"`, `"travel_tourism"`)
`action`	enum	No	Intent stage: `"discover"`, `"compare"`, or `"purchase"`
`preferences`	object	No	`{ budget_max?: number, features?: string[] }`
`userSummary`	string	Yes	One sentence summarizing user preferences
`limit`	number	No	Max results (default 5, max 50)

`aon_get_category_schema`

Get decision factors for a product category. Call before searching when intent is vague.

Parameter	Type	Required	Description
`category`	string	Yes	Category key or `"all"` to list categories

Common category ids: computers_electronics.computers.software, travel_tourism, jobs_education, finance.credit_lending, computers_electronics.consumer_electronics

Next Steps

Advanced Skill Development — Customize MCP tool behavior
TypeScript SDK — Build a custom agent with full SDK control
Best Practices — Production patterns and security

Start from Quick Start