EasyPost Agent Toolkit

API-first domain knowledge and SDK hints for AI coding agents to generate correct EasyPost shipping integration code — without hallucinating API shapes, parameters, or patterns.

What This Is

A curated set of agent instructions, reference guides, and SDK hints derived from real production EasyPost usage and official documentation. Designed for Claude Code, Cursor, Windsurf, Copilot, and any AI coding agent.

The toolkit is API-first: core knowledge uses HTTP examples, then thin SDK hints translate patterns into each supported language.

Directory Structure

├── AGENTS.md                              # Agent behavioral rules (all platforms)
├── CLAUDE.md                              # Claude Code-specific guidance
├── README.md                              # This file
└── skills/easypost/
    ├── SKILL.md                           # Core domain knowledge (API-first)
    ├── sdk-hints/
    │   ├── python.md                      # Python SDK patterns
    │   ├── nodejs.md                      # Node.js SDK patterns
    │   ├── ruby.md                        # Ruby SDK patterns
    │   ├── php.md                         # PHP SDK patterns
    │   ├── java.md                        # Java SDK patterns
    │   ├── csharp.md                      # C# SDK patterns
    │   ├── go.md                          # Go SDK patterns
    │   └── curl.md                        # Raw HTTP (curl) patterns
    └── references/
        ├── api-endpoints.md               # Complete HTTP endpoint reference
        ├── shipment-lifecycle.md           # Create → Rate → Buy → Track → Refund
        ├── rate-shopping.md               # Rates, SmartRate, Luma Select
        ├── international-customs.md       # Customs, HS codes, incoterms, EEI
        ├── batch-operations.md            # Batch workflow, async, scan forms
        ├── webhooks-events.md             # Events, payload, HMAC, retry
        ├── carrier-accounts.md            # Types, registration endpoints
        ├── error-handling.md              # Error shapes, rate errors, common codes
        ├── address-verification.md        # Verify methods, error codes
        ├── luma-smartrate.md              # Luma Promise/Select/Insights, SmartRate
        ├── support-kb.md                  # Curated support KB (glossary, FAQs)
        └── tax-identifiers.md             # IOSS, VOEC, GST, EORI, etc.

Installation

Manual

Clone or download this repository and place it in your project root or reference directory.

git clone https://github.com/sameerkumar18/easypost-agent-toolkit.git

For Claude Code

The CLAUDE.md file is automatically picked up when this repo is in your project directory.

For Cursor / Windsurf / Copilot

Point your agent's rules file to AGENTS.md and the skill documents under skills/easypost/.

Supported Languages

Language	Package	Min Version
Python	easypost	>= 10.0.0
Node.js	@easypost/api	>= 7.0.0
Ruby	easypost	>= 6.0.0
PHP	easypost/easypost-php	>= 6.0.0
Java	com.easypost:easypost-api	>= 7.0.0
C#	EasyPost-Official	>= 6.0.0
Go	github.com/EasyPost/easypost-go/v4	>= 4.0.0
curl / HTTP	—	—

Supported Platforms

• Claude Code
• Cursor
• Windsurf
• GitHub Copilot
• Any AI agent that reads markdown instruction files

Source

Reference guides are derived from EasyPost API documentation, support KB articles, and production integrations. All API patterns, parameter structures, and error handling are verified against official docs.