Koskamo

ShipNote MCP

This MCP server allows AI assistants like Claude to browse card designs, get pricing, and save thank-you postcards as drafts for printing and mailing. It integrates with various registry lists and guest lists, enabling users to initiate orders that are finalized on the ShipNote website.

Visit ShipNote

Endpoint and access

No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.

ShipNote MCP logo, by ShipNoteVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-02Operated by ShipNote
MCP endpoint (Streamable HTTP)
https://www.shipnote.co/api/mcp/claude
Vendor documentation

What its tools do

3 tools, grouped by the hints the server advertises. Hints are self-declared, not verified behavior.

Read-only (2)

Can change data (1)

3 of 3 have a description · 3 of 3 declare behavior hints · 1 of 3 with parameters document them all

Checks and signals

Each line is separate evidence, not a trust score.

  • Passed Endpoint answered the live check ·
  • Passed Official MCP Registry namespace is tied to shipnote.co ·
  • Passed Endpoint is on the registry namespace domain ·
  • Uptime 100% over 90 days
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Browse card designs for weddings, baby showers, and holidays
  • Get pricing for up to 500 postcards with postage included
  • Save thank-you postcards as drafts from a registry or guest list
  • Send a thank-you postcard to a specific person with a custom message

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: co.shipnote/shipnote@1.0.0Project website

Protocol and capabilities

Server
shipnote 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
3 advertised
Resources
Not advertised
Resource templates
Not advertised
Prompts
Not advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": true
  }
}

Server-provided instructions

Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.

ShipNote prints, stamps and mails real postcards to US addresses. list_card_designs shows the designs, quote_price gives a price, and create_draft saves a draft: for one person (a single thank-you postcard, one recipient) or for a whole registry or guest list. Nothing is mailed or charged from chat; the sender adds their return address, reviews the cards and pays on shipnote.co.

Tools

3 advertised

list_card_designs — Browse card designs
Advertised by the server during the last successful anonymous check.
Advertised read-only

List the occasions ShipNote makes postcards for, and the card designs available for one occasion, each with the id that create_draft accepts as design. Read-only: it saves nothing.

list_card_designs input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "occasion": {
      "type": "string",
      "maxLength": 64,
      "description": "Occasion id from this tool's occasion list, e.g. wedding, baby-shower, thank-you. Without it, the tool returns the list of occasions."
    }
  }
}
list_card_designs annotations
{
  "title": "Browse card designs",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
quote_price — Get a price quote
Advertised by the server during the last successful anonymous check.
Advertised read-only

Price for printing, stamping and mailing a number of ShipNote postcards within the US. Read-only: it saves nothing and charges nothing.

quote_price input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "cardCount"
  ],
  "properties": {
    "cardCount": {
      "type": "integer",
      "maximum": 500,
      "minimum": 1
    }
  }
}
quote_price annotations
{
  "title": "Get a price quote",
  "readOnlyHint": true,
  "openWorldHint": false,
  "destructiveHint": false
}
create_draft — Save cards as a draft
Advertised by the server during the last successful anonymous check.

Save a DRAFT of postcards, from a single card to one person (e.g. "send a thank-you postcard to my aunt") to a whole registry or guest list, and return a link where the sender adds their return address, reviews every card, and pays on shipnote.co. This tool never mails a card and never charges anyone. Each recipient is one card (one per household for a list): the name as it appears on the card, the full US mailing address as "Street, City, ST ZIP" (empty if unknown), and the gift as a short noun phrase without the store name (e.g. "stand mixer", not "KitchenAid stand mixer from Target"). senderName is the name the sender signs cards with; without it, the default message stays unsigned until the sender fills it in on shipnote.co. Up to 500 recipients per draft. Each call makes a new draft with a new link. This tool can't take a picture. A photo card (the sender's own picture as the whole front) is saved with design image-only, and the sender adds the photo on shipnote.co after opening the link; a photo inside a design uses a design marked (1 photo). list_card_designs also shows designs that need no photo.

create_draft input schema
{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "occasion",
    "recipients"
  ],
  "properties": {
    "design": {
      "type": "string",
      "maxLength": 64,
      "description": "A design id from list_card_designs for that occasion."
    },
    "message": {
      "type": "string",
      "maxLength": 1500,
      "description": "The card message, with [RECIPIENT] and [GIFT_NAME] as placeholders ShipNote fills in for each card. Defaults to the occasion's standard message."
    },
    "occasion": {
      "type": "string",
      "maxLength": 64,
      "description": "Supported occasion id from list_card_designs."
    },
    "recipients": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "name"
        ],
        "properties": {
          "name": {
            "type": "string",
            "maxLength": 100,
            "minLength": 1
          },
          "address": {
            "type": "string",
            "maxLength": 200
          },
          "giftName": {
            "type": "string",
            "maxLength": 100
          }
        }
      },
      "maxItems": 500,
      "minItems": 1
    },
    "senderName": {
      "type": "string",
      "maxLength": 60,
      "description": "How the sender signs, e.g. \"Sam & Alex\". Replaces [YOUR NAME] and becomes the return-address name."
    }
  }
}
create_draft annotations
{
  "title": "Save cards as a draft",
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}

Prompts

Not advertised

No prompt definitions available.

Resources

Not advertised

No resource definitions available.

90-day uptime

A lightweight connection check about every six hours, sampled on hosts with many listings. It shows the server answered, not that its tools work.

100% (19 of 19 checks answered)

  1. 2026-11-02: 1 of 1 checks answered
  2. 2026-11-03: 4 of 4 checks answered
  3. 2026-11-04: 4 of 4 checks answered
  4. 2026-11-05: 4 of 4 checks answered
  5. 2026-11-06: 4 of 4 checks answered
  6. 2026-11-07: 2 of 2 checks answered

30-day availability

Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.

Successful checks
1 of 1 (100%)
Average latency
4086 ms
95th percentile latency
4086 ms

Maintenance history

Public check and source-refresh events. Editorial and ownership records remain private.

  • · probe · passed · 4086 ms · metadata changed · 3 tool(s)

Connect from your client

Each snippet registers the same endpoint; pick the client you use.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http shipnote-mcp https://www.shipnote.co/api/mcp/claude

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add shipnote-mcp --url https://www.shipnote.co/api/mcp/claude

Cursor

Merge this server into .cursor/mcp.json in your project, then enable shipnote-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "shipnote-mcp": {
      "url": "https://www.shipnote.co/api/mcp/claude"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "shipnote-mcp": {
      "type": "streamableHttp",
      "url": "https://www.shipnote.co/api/mcp/claude",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start shipnote-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "shipnote-mcp": {
      "type": "http",
      "url": "https://www.shipnote.co/api/mcp/claude"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http shipnote-mcp https://www.shipnote.co/api/mcp/claude

Claude Desktop

Open Claude Settings > Connectors > Add custom connector, enter this server URL and enable it for the conversation. This is a manual remote-connector handoff, not a desktop JSON configuration.
Claude Desktop configuration
https://www.shipnote.co/api/mcp/claude

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "mcpServers": {
    "shipnote-mcp": {
      "serverUrl": "https://www.shipnote.co/api/mcp/claude"
    }
  }
}

Let your agent find its tools

Find servers like ShipNote MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.

Connect Koskamo Explore workflows
See all 1,666

Do you run ShipNote MCP?

Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.

Claim this listing