Python Skill Integration

Run AON offer search as a Python MCP server, powered by the agentoffernetwork Python SDK.

When to use this

Use the Python Skill if you're running a Python-based MCP host, or if you prefer Python over Node.js for your MCP server setup.

Prerequisites

Python 3.11+
uv (recommended) or pip
An AON API Key (get one here)

Installation

Option A: Zero-config install (Recommended)

uvx --from aon-demo-skill-python aon-demo-skill --install --global

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

Option B: Manage it through the CLI

npm install -g @agentoffernetwork/cli
aon skill install aon-demo-skill-python --runtime python

Option C: Local development install

cd sdk/python-skill
uv sync --dev
uv run aon-demo-skill

MCP Configuration

Add the Python Skill to your Claude Desktop config:

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

{
  "mcpServers": {
    "agentoffernetwork-skill-python": {
      "command": "uvx",
      "args": ["--from", "aon-demo-skill-python", "aon-demo-skill"]
    }
  }
}

Restart Claude Desktop after saving.

Available Tools

The Python Skill exposes the same two MCP tools as the TypeScript Skill:

`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	`"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.

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

Running Locally (Development)

The server communicates over stdio, following the MCP transport spec:

cd sdk/python-skill
uv sync --dev
uv run aon-demo-skill

Verify Installation

Test with these prompts in Claude:

"Find me budget laptops under $500"
"Compare SaaS tools for team project management"
"What Python courses are available online?"

Troubleshooting

Issue	Solution
"No such command"	Verify Python and uv/pip are in your PATH
"Module not found"	Run `pip install agentoffernetwork` or `uv sync` first
Empty results	Check API key validity. Try broader search terms

Next Steps

Python SDK — Direct SDK usage for custom Python agents
Claude Integration — TypeScript-based Skill (alternative)
Advanced Skill Development — Build custom MCP tools

Start from Quick Start