Koskamo

Vintage Postcard MCP

This MCP server enables AI agents to browse the vintage travel poster catalog, calculate shopping cart quotes including shipping, and initiate payments via Stripe. It supports agentic commerce by allowing agents to discover products, get pricing, and complete transactions autonomously.

Visit Vintage Postcard

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.

Vintage Postcard MCP logo, by Vintage PostcardVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-07Operated by Vintage Postcard
MCP endpoint (Streamable HTTP)
https://vintage-postcard.fr/mcp
Vendor documentation

What its tools do

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

Read-only (7)

Can change data (3)

10 of 10 have a description · 10 of 10 declare behavior hints · 1 of 7 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 vintage-postcard.fr ·
  • Passed Endpoint is on the registry namespace domain ·
  • Availability 1 of 1 checks passed in 30 days

What you can do with it

  • Search the vintage poster catalog by destination or style
  • Calculate shopping cart quotes with shipping costs
  • Initiate and complete payments via Stripe integration

Source and maintenance

Vendor evidenceRegistry 1.0.0
mcp-registry: fr.vintage-postcard/boutique@1.0.0Source repositoryProject website
Maintenance checked

Protocol and capabilities

Server
vintage-postcard 1.0.0
MCP protocol negotiated in check
2025-06-18
Tools
10 advertised
Resources
4 advertised
Resource templates
1 advertised
Prompts
2 advertised
Server-advertised capabilities
{
  "tools": {
    "listChanged": false
  },
  "logging": {},
  "prompts": {
    "listChanged": false
  },
  "resources": {
    "subscribe": false,
    "listChanged": false
  }
}

Server-provided instructions

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

Vintage Postcard est une boutique française d'affiches et posters vintage inspirés des cartes postales de voyage (villes, îles, paysages), imprimés en France. Méthode conseillée : 1. `search_postcards` pour trouver une affiche (par ville, pays, région ou mot-clé) ; `list_destinations` pour explorer le catalogue par pays. 2. `get_postcard` pour le détail d'une affiche (prix, promo, formats, image). 3. `quote_cart` pour le total exact : cadre (+1,75 €) et livraison (2,99 €, offerte dès 30 €) inclus. 4. `start_order` pour ouvrir la commande (panier + email du client), puis `pay_order` pour payer. Paiement : par défaut `pay_order` renvoie un lien Stripe que vous transmettez à votre utilisateur — c'est lui qui valide la carte. Le paiement délégué (confirmation immédiate avec un token de paiement) n'est possible que pour les agents disposant d'une clé API émise par la boutique, et reste plafonné. Ne jamais inventer un prix ni une disponibilité : toutes les valeurs viennent des outils. Devise : EUR. Catalogue complet aussi disponible en lecture directe sur https://vintage-postcard.fr/feed/products.json et https://vintage-postcard.fr/llms-full.txt.

Tools

10 advertised

search_postcards — Rechercher des affiches
Advertised by the server during the last successful anonymous check.
Advertised read-only

Recherche dans tout le catalogue d'affiches vintage par mot-clé (ville, pays, région, thème), collection et filtres de prix. Renvoie les affiches avec prix, promo, image et URL de la page produit.

search_postcards input schema
{
  "type": "object",
  "properties": {
    "sort": {
      "enum": [
        "relevance",
        "price_asc",
        "price_desc",
        "name"
      ],
      "type": "string",
      "default": "relevance"
    },
    "limit": {
      "type": "integer",
      "default": 12,
      "maximum": 100,
      "minimum": 1
    },
    "query": {
      "type": "string",
      "description": "Mot-clé : ville, pays, paysage… ex. « Lisbonne », « île »"
    },
    "offset": {
      "type": "integer",
      "default": 0,
      "minimum": 0
    },
    "region": {
      "type": "string",
      "description": "Filtre région exact"
    },
    "country": {
      "type": "string",
      "description": "Filtre pays exact, ex. « Portugal »"
    },
    "max_price": {
      "type": "number",
      "description": "Prix maximum en euros"
    },
    "min_price": {
      "type": "number",
      "description": "Prix minimum en euros"
    },
    "collection": {
      "type": "string",
      "description": "Filtre collection exact : « Destinations » (affiches de villes) ou « Vintage »"
    }
  },
  "additionalProperties": false
}
search_postcards annotations
{
  "title": "Rechercher des affiches",
  "readOnlyHint": true,
  "openWorldHint": false
}
get_postcard — Détail d'une affiche
Advertised by the server during the last successful anonymous check.
Advertised read-only

Fiche complète d'une affiche : description, prix, prix barré, formats, option cadre, image, frais de port et affiches similaires. Accepte un identifiant ou un nom de ville.

get_postcard input schema
{
  "type": "object",
  "anyOf": [
    {
      "required": [
        "product_id"
      ]
    },
    {
      "required": [
        "name"
      ]
    }
  ],
  "properties": {
    "name": {
      "type": "string",
      "description": "Nom de la ville / du lieu"
    },
    "product_id": {
      "type": "integer",
      "description": "Identifiant de l'affiche"
    }
  },
  "additionalProperties": false
}
get_postcard annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
list_destinations — Lister les destinations
Advertised by the server during the last successful anonymous check.
Advertised read-only

Toutes les destinations du catalogue, groupées par pays avec le nombre d'affiches et quelques exemples.

list_destinations input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
list_destinations annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
get_catalog_overview — Vue générale du catalogue
Advertised by the server during the last successful anonymous check.
Advertised read-only

Chiffres clés de la boutique : nombre d'affiches, pays couverts, fourchette de prix, formats, prix du cadre, règles de livraison.

get_catalog_overview input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_catalog_overview annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
quote_cart — Calculer un panier
Advertised by the server during the last successful anonymous check.
Advertised read-only

Devis exact d'un panier : sous-total, option cadre, frais de livraison (offerts dès 30 €) et total. À utiliser avant d'annoncer un prix au client.

quote_cart input schema
{
  "type": "object",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_id"
        ],
        "properties": {
          "size": {
            "enum": [
              "A5",
              "A4",
              "A3"
            ],
            "type": "string",
            "default": "A4"
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 50,
            "minimum": 1
          },
          "product_id": {
            "type": "integer"
          },
          "with_frame": {
            "type": "boolean",
            "default": false
          }
        },
        "additionalProperties": false
      },
      "minItems": 1
    }
  },
  "additionalProperties": false
}
quote_cart annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
start_order — Ouvrir une commande
Advertised by the server during the last successful anonymous check.

Crée une session de commande pour le client (panier + email + adresse de livraison optionnelle) et renvoie son identifiant, à utiliser ensuite avec `pay_order`. Aucun paiement n'est déclenché à cette étape.

start_order input schema
{
  "type": "object",
  "required": [
    "items",
    "email"
  ],
  "properties": {
    "email": {
      "type": "string",
      "description": "Email du client (confirmation de commande)"
    },
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "product_id"
        ],
        "properties": {
          "size": {
            "enum": [
              "A5",
              "A4",
              "A3"
            ],
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "maximum": 50,
            "minimum": 1
          },
          "product_id": {
            "type": "integer"
          },
          "with_frame": {
            "type": "boolean",
            "default": false
          }
        },
        "additionalProperties": false
      },
      "minItems": 1
    },
    "last_name": {
      "type": "string"
    },
    "first_name": {
      "type": "string"
    },
    "shipping_address": {
      "type": "object",
      "properties": {
        "city": {
          "type": "string"
        },
        "address": {
          "type": "string"
        },
        "country": {
          "type": "string",
          "default": "France"
        },
        "zip_code": {
          "type": "string"
        }
      },
      "additionalProperties": false
    }
  },
  "additionalProperties": false
}
start_order annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "idempotentHint": false,
  "destructiveHint": false
}
pay_order — Payer la commande
Advertised by the server during the last successful anonymous check.
Open-world

Déclenche le paiement d'une session ouverte avec `start_order`. • method="hosted_checkout" (défaut) : renvoie un lien de paiement Stripe à transmettre au client, qui confirme lui-même sa carte. • method="delegated_token" : confirme immédiatement le paiement avec un token délégué. Réservé aux agents authentifiés par une clé API de la boutique, et plafonné par commande.

pay_order input schema
{
  "type": "object",
  "required": [
    "session_id"
  ],
  "properties": {
    "method": {
      "enum": [
        "hosted_checkout",
        "delegated_token"
      ],
      "type": "string",
      "default": "hosted_checkout"
    },
    "session_id": {
      "type": "string",
      "description": "Identifiant renvoyé par `start_order`"
    },
    "payment_token": {
      "type": "string",
      "description": "Token de paiement délégué (Stripe), pour delegated_token"
    }
  },
  "additionalProperties": false
}
pay_order annotations
{
  "readOnlyHint": false,
  "openWorldHint": true,
  "idempotentHint": false,
  "destructiveHint": false
}
get_order_status — Suivre une commande
Advertised by the server during the last successful anonymous check.
Advertised read-only

Statut d'une commande (en attente, payée, annulée) à partir de son numéro et de l'email du client, ou de l'identifiant de session de commande.

get_order_status input schema
{
  "type": "object",
  "properties": {
    "email": {
      "type": "string"
    },
    "order_id": {
      "type": "integer"
    },
    "session_id": {
      "type": "string"
    }
  },
  "additionalProperties": false
}
get_order_status annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}
request_custom_poster — Demander une affiche personnalisée
Advertised by the server during the last successful anonymous check.

Enregistre une demande de création d'affiche vintage sur mesure (ville, style, précisions). L'équipe recontacte le client par email avec une proposition.

request_custom_poster input schema
{
  "type": "object",
  "required": [
    "email",
    "city"
  ],
  "properties": {
    "city": {
      "type": "string",
      "description": "Ville ou lieu à illustrer"
    },
    "email": {
      "type": "string"
    },
    "style": {
      "type": "string",
      "description": "Style souhaité, ex. « vintage années 50 »"
    },
    "additional_info": {
      "type": "string",
      "description": "Précisions, souvenir, couleurs…"
    }
  },
  "additionalProperties": false
}
request_custom_poster annotations
{
  "readOnlyHint": false,
  "openWorldHint": false,
  "destructiveHint": false
}
get_store_policies — Conditions de la boutique
Advertised by the server during the last successful anonymous check.
Advertised read-only

Livraison, retours, formats, moyens de paiement et FAQ. À citer plutôt que de deviner.

get_store_policies input schema
{
  "type": "object",
  "properties": {},
  "additionalProperties": false
}
get_store_policies annotations
{
  "readOnlyHint": true,
  "openWorldHint": false
}

Prompts

2 advertised

choisir_une_affiche — Choisir une affiche

Advertised by the server during the last successful anonymous check.

Aide à choisir une affiche vintage selon un lieu, un budget ou une occasion.

destination
Ville, pays ou type de paysage (required)
budget
Budget indicatif en euros
commander_une_affiche — Commander une affiche

Advertised by the server during the last successful anonymous check.

Déroulé complet : recherche, devis, ouverture de commande et paiement.

destination
Ville ou lieu souhaité (required)
email
Email du client

Resources

4 advertised

catalogue-complet — Catalogue complet

Advertised by the server during the last successful anonymous check.

Toutes les affiches avec prix, images, options et URL.

catalogue-complet URI
postcard://catalog

MIME type: application/json

destinations — Destinations par pays

Advertised by the server during the last successful anonymous check.

Pays et régions couverts, avec le nombre d'affiches.

destinations URI
postcard://destinations

MIME type: application/json

conditions — Livraison, retours et paiement

Advertised by the server during the last successful anonymous check.

Conditions commerciales de la boutique.

conditions URI
postcard://policies

MIME type: application/json

catalogue-markdown — Catalogue en markdown

Advertised by the server during the last successful anonymous check.

Catalogue complet en texte, prêt à être cité.

catalogue-markdown URI
postcard://catalog.md

MIME type: text/markdown

affiche — Fiche d'une affiche

Advertised by the server during the last successful anonymous check.

Détail d'une affiche par identifiant.

affiche URI template
postcard://product/{id}

MIME type: application/json

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
1055 ms
95th percentile latency
1055 ms

Maintenance history

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

  • · probe · passed · 1055 ms · metadata changed · 10 tool(s), 4 resource(s), 1 resource template(s), 2 prompt(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 vintage-postcard-mcp https://vintage-postcard.fr/mcp

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 vintage-postcard-mcp --url https://vintage-postcard.fr/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable vintage-postcard-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "vintage-postcard-mcp": {
      "url": "https://vintage-postcard.fr/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "vintage-postcard-mcp": {
      "type": "streamableHttp",
      "url": "https://vintage-postcard.fr/mcp",
      "disabled": false
    }
  }
}

VS Code

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

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 vintage-postcard-mcp https://vintage-postcard.fr/mcp

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://vintage-postcard.fr/mcp

Windsurf

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

Let your agent find its tools

Find servers like Vintage Postcard 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,637

Do you run Vintage Postcard 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