upgrade-shippo

upgrade-shippo is a skill for Claude Code from goshippo/ai. It costs 67 tokens per session (748 once invoked), scanned A, original, MIT.

A guide to handling Shippo API changes when using Shippo’s hosted MCP server, which lets an agent connect to Shippo through a managed service. It covers API compatibility, webhook data changes, and connection errors.

In plain words
What is it for?
Use it when updating Shippo integrations, reviewing webhook handlers, investigating hosted-MCP connection problems, or checking whether an API change could affect existing code.
Why use it?
It helps you avoid breaking integrations when Shippo adds fields, changes webhook data, or reports an API-version or OAuth mismatch. The hosted server manages its own version, so you mainly need to handle incoming changes correctly.

Skill for Claude Code

Written for Claude Code: shipped in a Claude Code plugin. Also seen: mentions Claude Code.

Part of the shippo plugin — 9 skills, 1 MCP server shipped together

Good fit Use it when updating Shippo integrations, reviewing webhook handlers, investigating hosted-MCP connection problems, or checking whether an API change could affect existing code.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/goshippo/ai/upgrade-shippo
View source ↗ goshippo/ai
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add goshippo/ai --skill upgrade-shippo
Clone the repo
git clone --depth 1 https://github.com/goshippo/ai

Made for: Claude Code.

Or install shippo, the plugin that ships this one along with the rest of its 9 skills, 1 MCP server.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for upgrade-shippo

README.md
[![agentmods](https://agentmods.dev/badge/skills/goshippo/ai/upgrade-shippo/github.svg)](https://agentmods.dev/skills/goshippo/ai/upgrade-shippo)
Your own site
<a href="https://agentmods.dev/skills/goshippo/ai/upgrade-shippo"><img src="https://agentmods.dev/badge/skills/goshippo/ai/upgrade-shippo/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for upgrade-shippo

Your own site · 80×15
<a href="https://agentmods.dev/skills/goshippo/ai/upgrade-shippo"><img src="https://agentmods.dev/badge/skills/goshippo/ai/upgrade-shippo.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 67 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 748 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00067 $0.00748
Opus 5 $0.00034 $0.00374
Sonnet 5 $0.00013 $0.00150
Haiku 4.5 $0.00007 $0.00075

Measured 10d ago against content hash eb74251f6442, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-09, from the pricing page.

Security

Grade A, and why

upgrade-shippo scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 10d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

providers/claude/plugin/skills/upgrade-shippo/SKILL.md · 61 lines

How it starts

The opening of the file, as written. The whole thing — 61 lines — stays where its author put it; the contents beside it link to each section on GitHub.

The Shippo MCP is hosted at https://mcp.shippo.com. It is OAuth-only and auto-updates server-side, so there is nothing to install or upgrade on your side. This skill covers what stays your responsibility: API version awareness, webhook payload versioning, and troubleshooting the hosted session.

API version handling

The current Shippo API version is 2018-02-08. Shippo uses a single long-lived API version, and the hosted server manages it for you server-side. You do not set the Shippo-API-Version header yourself when going through the hosted MCP.

What backward-compatibility means in practice:

  • Most changes are backward-compatible: new optional fields, new resources, additional webhook events. Existing calls keep working.
  • Breaking changes are rare and announced via release notes.
  • Because the server picks the version, you don't pin anything client-side. Your job is to handle new fields gracefully (see webhook versioning below) rather than to manage versions.

Shippo API changes are tracked in the API changelog. As of 2026-06, no recent breaking changes affect the workflows covered by this skill set.

Webhook event versioning

Webhook events can include new fields without bumping the API version. To handle them gracefully:

  • Default to ignoring unknown fields in your webhook handler, never fail-closed on a field you don't recognize.
  • Subscribe only to the specific event types you need (track_updated, transaction_created, transaction_updated, etc.).
  • Verify webhook signatures using the Shippo-Signature header per webhook docs.

Troubleshooting the hosted MCP

401 or 403 errors

The OAuth session has expired or is not authorized. Re-authorize the Shippo OAuth session: in Claude Code, run /mcp and sign in again.

Read the full file on GitHub · 61 lines

Files

What ships with it

1 file beside SKILL.md in the same directory: the scripts, references and assets a skill reads on demand. Not counted in the per-session cost; read them before you install if any of them is executable.

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 10d ago First seen · 61 lines · 67 tokens per session scan A eb74251f6442

Subscribe to this mod's changes

upgrade-shippo is a skill published in the GitHub repository goshippo/ai (2 stars, last pushed 5d ago), licensed MIT. It adds 67 tokens to every session and 748 once invoked, about $0.0003 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

inbound-email

Handle email arriving at a ServiceNow instance — inbound email action ordering and stop-processing, the real syseventinemailaction column names, and reading sysemail when a message created no record.

serac-labs/serac · 43 tokens

background-script-execution

What actually happens when you call snowexecutescript — the Scripted REST endpoint Serac auto-deploys on first use, the scheduled-job fallback, what scheduledjobpending means, and how to get output back when the call comes home empty.

serac-labs/serac · 54 tokens

csdm-modeling

Pick the right ServiceNow service class under the Common Service Data Model — business service, service offering, application service, business application — and point the CMDB tools at it without creating the records CSDM tells customers to migrate away from.

serac-labs/serac · 53 tokens

mcp-tool-discovery

Find and call tools on this ServiceNow MCP server — the two meta-tools it starts with, why a missing session id makes every other tool unreachable, which queries actually match, and which advertised tools are not on the server at all.

serac-labs/serac · 53 tokens

cmdb-patterns

Create ServiceNow CIs and cmdbrelci relationships, walk upstream/downstream impact, detect orphan/stale CIs, and align discovered CIs with the proper sysclassname hierarchy.

serac-labs/serac · 43 tokens

catalog-items

Build ServiceNow Service Catalog items, variables, variable sets, catalog client scripts, record producers, and order guides with reference qualifiers and dynamic pricing.

serac-labs/serac · 32 tokens