Skip to content
Scalekit Docs
Talk to an Engineer Dashboard

Connect AI agents to EasyPost

Scalekit connector
Open markdown

The EasyPost connector lets your AI agent act in each user's EasyPost account. Each user connects their own EasyPost API key once, and Scalekit sends it with every call, so your agent never handles credentials. It comes with 30 tools.

Tools
30
What they doRead · write · destructive
16 · 11 · 316 read11 write3 destructive
Users sign in with

Setup

  1. Install the SDK

    Terminal window
    npm install @scalekit-sdk/node dotenv
  2. Set your credentials

    Add your Scalekit credentials to your .env file. Find values in app.scalekit.com > Developers > API Credentials.

    .env
    SCALEKIT_ENVIRONMENT_URL=<your-environment-url>
    SCALEKIT_CLIENT_ID=<your-client-id>
    SCALEKIT_CLIENT_SECRET=<your-client-secret>
  3. Create the EasyPost connection

    In AgentKit > Connections, create an EasyPost connection. The name you give it is the connection_name your code passes. See Configure connections.

Tools

Pass the exact name to execute_tool
Try in PlaygroundRequest a tool
  • easypost_address_getGet one address by ID.Read-only

    Get Address

    Get one address by ID. Returns the Address with its fields, residential flag and any verification results. Use easypost_address_get for a known ID. Use easypost_addresses_list to browse.

    Inputs

    address_idstringrequired
    ID of the address, starting with adr_. Example: adr_7c2f357c2d1511f087fbac1f6bc539ae
  • easypost_address_verifyRun delivery and ZIP+4 verification on an address that already exists.Read-only

    Verify Address

    Run delivery and ZIP+4 verification on an address that already exists. Returns the Address with verifications results and any corrections. Use easypost_address_verify for a saved address ID. Use easypost_address_create_and_verify for a new address.

    Inputs

    address_idstringrequired
    ID of the address, starting with adr_. Example: adr_7c2f357c2d1511f087fbac1f6bc539ae
  • easypost_addresses_listList the account's addresses, newest first, with cursor paging.Read-only

    List Addresses

    List the account's addresses, newest first, with cursor paging. Returns addresses[] and has_more. Use easypost_addresses_list to browse addresses. Use easypost_address_get for one.

    Inputs

    after_idstring
    Return records created after this ID. Example: adr_abc123
    before_idstring
    Return records created before this ID; pass the last ID of the previous page to get the next page. Example: adr_abc123
    end_datetimestring
    Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
    page_sizeinteger
    Records per page, up to 100 (default 20). Example: 20
    start_datetimestring
    Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
  • easypost_events_listList webhook events (tracker updates, batch and refund changes, payments), newest first.Read-only

    List Events

    List webhook events (tracker updates, batch and refund changes, payments), newest first. Returns events[] with id, description (such as tracker.updated), status, result and created_at, and has_more. Use easypost_events_list to audit what EasyPost sent to webhooks.

    Inputs

    after_idstring
    Return records created after this ID. Example: evt_abc123
    before_idstring
    Return records created before this ID; pass the last ID of the previous page to get the next page. Example: evt_abc123
    end_datetimestring
    Only records created before this ISO 8601 date-time. Example: 2026-11-15T00:00:00Z
    page_sizeinteger
    Records per page, up to 100 (default 20). Example: 20
    start_datetimestring
    Only records created at or after this ISO 8601 date-time. Example: 2026-11-01T00:00:00Z
  • easypost_parcel_getGet one parcel by ID.Read-only

    Get Parcel

    Get one parcel by ID. Returns the Parcel with length, width, height, weight and predefined_package. Use easypost_parcel_get for a known parcel ID.

    Inputs

    parcel_idstringrequired
    ID of the parcel, starting with prcl_. Example: prcl_e0aab4dd1d4d4f9d8a64b0d1a4b4a2d7
  • easypost_pickup_getGet one pickup by ID.Read-only

    Get Pickup

    Get one pickup by ID. Returns the Pickup with status, confirmation, min and max datetime, address and pickup_rates. Use easypost_pickup_get to check a pickup's status.

    Inputs

    pickup_idstringrequired
    ID of the pickup, starting with pickup_. Example: pickup_0b1c2d3e4f5a6b7c8d9e0f1a2b3c4d5e
  • easypost_rates_retrieveGet carrier rates for a package without creating a shipment (stateless rating, beta endpoint).Read-only

    Retrieve Rates

    Get carrier rates for a package without creating a shipment (stateless rating, beta endpoint). Returns rates[] with carrier, service, rate, currency and delivery_days; the rates cannot be bought. Use easypost_rates_retrieve for quotes. Use easypost_shipment_create when you will buy a label.

    Inputs

    from_addressobjectrequired
    Origin address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"company": "EasyPost", "street1": "417 Montgomery Street", "street2": "5th Floor", "city": "San Francisco", "state": "CA", "zip": "94104", "country": "US", "phone": "4153334445"}
    parcelobjectrequired
    Package: length, width and height in inches and weight in ounces, or predefined_package, or {"id": "prcl_..."}. Example: {"length": 20.2, "width": 10.9, "height": 5, "weight": 65.9}
    to_addressobjectrequired
    Destination address: an object with name, company, street1, street2, city, state, zip, country, phone and email, or {"id": "adr_..."} for a saved address. Example: {"name": "Dr. Steve Brule", "street1": "179 N Harbor Dr", "city": "Redondo Beach", "state": "CA", "zip": "90277", "country": "US", "phone": "8573875756"}
    carrier_accountsarray
    Carrier account IDs (ca_...) to rate with; defaults to all of the account's carriers. Example: ["ca_8dc116debcdb49b5a66a2ddee4612600"]
  • easypost_refund_getGet one label refund request by ID.Read-only

    Get Refund

    Get one label refund request by ID. Returns the Refund with tracking_code, confirmation_number, status, carrier and shipment_id. Use easypost_refund_get for a known refund ID.

    Inputs

    refund_idstringrequired
    ID of the refund, starting with rfnd_. Example: rfnd_d3e4f5a6b7c84d9e0f1a2b3c4d5e6f7a