com.premierletters/mcp

Est-ce que com.premierletters/mcp est sûr ?

Au dernier audit MCP Hub, le serveur MCP « com.premierletters/mcp » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 12 outils

• check_connection≈ 125 tokens

  Check whether the user approved a connect_account request. Returns status pending, denied, expired or claimed, or, exactly once, status approved with the api_key. Poll every 10-30 seconds.

  Paramètres, retour & exemple (2)

  Paramètres

  • request_id · string · requis
    request_id from connect_account.
  • poll_secret · string · requis
    poll_secret from connect_account.

  Exemple d'appel

  {"name": "check_connection", "arguments": {"request_id": "texte", "poll_secret": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• connect_account≈ 246 tokens

  Get a Premier Letters API key without the user copying one by hand. Pass the user's email and your name; we email them a link to approve (they can sign up from it if they have no account). Then call check_connection with the returned request_id and poll_secret every 10-30 seconds until it returns the api_key (returned once). Show the returned user_code to the user so they can match it on the approval page. No account or key needed to call this.

  Paramètres, retour & exemple (3)

  Paramètres

  • mode · string · optionnel · live | test
    Key mode. Defaults to "live".
  • email · string · requis
    The account owner's email address. The approval link is sent here.
  • agent_name · string · requis
    Your name as the user will see it, 1-80 characters: letters, digits, spaces and . , ' & ( ) - _ only (no links), e.g. "Claude".

  Exemple d'appel

  {"name": "connect_account", "arguments": {"email": "texte", "agent_name": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_order≈ 881 tokens

  Create and pay for a Premier Letters order — a real, handwritten letter mailed via USPS. Requires a Premier Letters API key. Use get_pricing or preview_letter first to confirm the price. For payment, "card_on_file" charges the caller's saved card immediately, "balance" pays from the prepaid account balance (no small-order handling fee; fails with insufficient_balance when short), or "checkout_session" returns a checkout_url for the human to complete payment in a browser. Envelope orders use return_address if given, otherwise the account's default return address; with neither, set no_return_address_ack: true to send without one.

  Paramètres, retour & exemple (9)

  Paramètres

  • message · string · requis
    The letter text. Supports {{first_name}}, {{last_name}}, {{greeting}} merge fields per-recipient.
  • options · object · optionnel
    handwriting_style, paper_type, product_type, mailing_option, authenticity_preset, include_letter, include_envelope, copies, output_mode ("handwritten" default, or "printed_bw" / "printed_color" to print the letter body) and envelope_output_mode (null default = hand-addressed, or "printed_bw" / "printed_color") — see /openapi.json for the full field list.
  • payment · object · optionnel
  • recipients · array · optionnel
    One or more recipients. At least one is required unless options.product_type is a letter/card with no envelope.
  • skip_invalid · boolean · optionnel
    When true, invalid recipients are skipped instead of failing the whole order.
  • return_address · object · optionnel
    Return address written on the envelope. Omit to use the account's default return address. Required unless the account has a default or no_return_address_ack is true. name, address_line1, city, state and zip are required unless return_address_partial_ok is true.
  • idempotency_key · string · optionnel
    Client-supplied key (1–255 chars). Repeating a call with the same key returns the original order instead of creating a second one. Always set this when you might retry.
  • no_return_address_ack · boolean · optionnel
    Send with no return address at all. Only honoured when no return_address is given and the account has no default. Undeliverable mail is then destroyed.
  • return_address_partial_ok · boolean · optionnel
    Send return_address exactly as written although it is incomplete: at least one of name, company, address_line1, city, state, zip. Only the filled lines print (a name alone is fine). Without it an incomplete return_address is refused.

  Exemple d'appel

  {"name": "create_order", "arguments": {"message": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_topup_link≈ 134 tokens

  Create a Stripe Checkout link that adds prepaid credit (plus any bonus tier) to the authenticated account. Give checkout_url to the human to pay in a browser; the balance updates once they pay (check with get_balance). amount_cents must be a whole number between min_cents and max_cents from get_balance.

  Paramètres, retour & exemple (1)

  Paramètres

  • amount_cents · integer · requis
    Amount to add, in cents (e.g. 5000 for $50.00).

  Exemple d'appel

  {"name": "create_topup_link", "arguments": {"amount_cents": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_balance≈ 90 tokens

  Get the authenticated account's prepaid balance (balance_cents) and the top-up rules: minimum and maximum top-up, bonus tiers and suggested amounts. Orders paid with payment.method "balance" skip the small-order handling fee. Use create_topup_link to add funds.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_balance", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_order_status≈ 74 tokens

  Get an order's status, delivery/tracking summary, and per-recipient mail status.

  Paramètres, retour & exemple (1)

  Paramètres

  • order_id · string · requis
    The order UUID returned by create_order.

  Exemple d'appel

  {"name": "get_order_status", "arguments": {"order_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_pricing≈ 484 tokens

  Get a live price quote for a Premier Letters order. Pass char_count (or letter_count for a rough estimate) plus optional mailing_option and paper_type to get a per-piece and total price, in cents. No account needed. Orders under 5 pieces carry a $0.99 per-piece handling fee (included in total_cents), waived when paid from a prepaid balance. Pass output_mode (printed_bw / printed_color) to quote a printed letter body instead of a pen-written one, and envelope_output_mode to quote a printed envelope.

  Paramètres, retour & exemple (7)

  Paramètres

  • char_count · number · optionnel
    Length of the letter message in characters. Longer letters cost more (character meter).
  • paper_type · string · optionnel · standard | premium
    Paper quality. Defaults to "standard".
  • output_mode · string · optionnel · handwritten | printed_bw | printed_color
    Defaults to "handwritten". printed_bw / printed_color print the letter body instead of pen-writing it; the envelope stays hand-addressed unless envelope_output_mode is set.
  • letter_count · number · optionnel
    Number of recipients / pieces. Defaults to 1.
  • product_type · string · optionnel · letter | card | a7 | postcard | card_5x7 | postcard_5x7 | a4 | a5
    Product type (letter, card, postcard, etc). Informational only — does not change pricing components beyond envelope inclusion.
  • mailing_option · string · optionnel · we_mail | you_mail_stamped | you_mail_no_stamp
    Delivery option. Defaults to "we_mail" (we write, stamp, and mail it for you).
  • envelope_output_mode · string · optionnel · printed_bw | printed_color
    Omit (or null) for a hand-addressed envelope, the default. printed_bw / printed_color print the envelope instead.

  Exemple d'appel

  {"name": "get_pricing", "arguments": {"char_count": 1, "paper_type": "standard", "output_mode": "handwritten", "letter_count": 1, "product_type": "letter", "mailing_option": "we_mail"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_handwriting_styles≈ 70 tokens

  List available handwriting styles (fonts) for a letter order. Use the returned "id" as options.handwriting_style / handwriting_style when creating an order or previewing.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_handwriting_styles", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_orders≈ 95 tokens

  List the authenticated user's recent orders.

  Paramètres, retour & exemple (2)

  Paramètres

  • limit · number · optionnel
    Max orders to return (1-100). Defaults to 20.
  • status · string · optionnel
    Optional status filter (pending_payment, paid, in_production, mailed, delivered, cancelled, refunded).

  Exemple d'appel

  {"name": "list_orders", "arguments": {"limit": 1, "status": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_templates≈ 114 tokens

  List the authenticated user's saved letter templates.

  Paramètres, retour & exemple (3)

  Paramètres

  • sort · string · optionnel · recent | most_used | name
    Sort order. Defaults to "recent".
  • search · string · optionnel
    Filter templates by name or content substring.
  • favorites_only · boolean · optionnel
    Only return favorited templates.

  Exemple d'appel

  {"name": "list_templates", "arguments": {"sort": "recent", "search": "texte", "favorites_only": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• preview_letter≈ 202 tokens

  Render a preview of a handwritten letter (as an SVG image) and get its price, before creating an order. Does not save anything.

  Paramètres, retour & exemple (4)

  Paramètres

  • message · string · requis
    The letter text to render.
  • recipient · object · optionnel
    Optional recipient info, used only to personalize {{merge fields}} in the message before rendering.
  • product_type · string · optionnel
    Product slug: letter, card, postcard, etc. Defaults to "letter".
  • handwriting_style · string · optionnel
    Font UUID from list_handwriting_styles. Defaults to the house font.

  Exemple d'appel

  {"name": "preview_letter", "arguments": {"message": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• verify_address≈ 151 tokens

  Verify and standardize a US mailing address via USPS. Use before create_order to catch typos and get the USPS-standardized form.

  Paramètres, retour & exemple (5)

  Paramètres

  • zip · string · requis
    5-digit or ZIP+4 postal code
  • city · string · requis
  • state · string · requis
    Two-letter US state code
  • address_line1 · string · requis
    Street address
  • address_line2 · string · optionnel
    Apt/suite/unit (optional)

  Exemple d'appel

  {"name": "verify_address", "arguments": {"zip": "texte", "city": "texte", "state": "texte", "address_line1": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://www.premierletters.com/api/mcp