# Claude Integration

Source: https://docs.aon.pro/guides/integration/claude

> Derived from the same AON Docs release as the source page.

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](https://docs.aon.pro/mcp) is the better starting point — no local install, the available tools, and issued-key setup. See the [MCP Quick Start](https://docs.aon.pro/mcp/quickstart).

> 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:

```bash
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:

```bash
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

```bash
# 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`:

```json
{
  "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:

```json
{
  "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

```bash
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:

```markdown
---
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](https://docs.aon.pro/guides/skill-plugin) — Customize MCP tool behavior
-   [TypeScript SDK](https://docs.aon.pro/guides/sdk-typescript) — Build a custom agent with full SDK control
-   [Best Practices](https://docs.aon.pro/guides/best-practices) — Production patterns and security

[Start from Quick Start](https://docs.aon.pro/quickstart)