Skip to main content
Glama
@formegifts/mcp

@formegifts/mcp

Official
by formegifts

@formegifts/mcp

MCP server for the forme.gifts wishlist app — manage wishlists and gifts from Claude Code, Claude Desktop, Cursor, and other MCP clients.

Install

Claude Code:

claude mcp add --scope user formegifts -- npx -y @formegifts/mcp

Claude Desktop — add to claude_desktop_config.json:

{
  "mcpServers": {
    "formegifts": {
      "command": "npx",
      "args": ["-y", "@formegifts/mcp"]
    }
  }
}

Cursor — add to MCP config:

{
  "mcpServers": {
    "formegifts": {
      "command": "npx",
      "args": ["-y", "@formegifts/mcp"]
    }
  }
}

Any MCP host:

npx -y @formegifts/mcp

Install links for each host will be added in a future release. See forme.gifts/mcp for the latest.

Related MCP server: swagger-petstore-mcp

Authentication

The first time you use any tool, the server will return an unauthenticated error pointing at the auth_start tool. Just ask your MCP host (Claude Code, Claude Desktop, Cursor, …) to sign you in — it will call auth_start, show you a verification URL and short code, and complete the sign-in via auth_poll after you approve in your browser.

If you'd rather sign in from a terminal (handy for CI or pre-warming credentials):

npx @formegifts/mcp auth

If installed globally (npm install -g @formegifts/mcp), use formegifts-mcp directly (forme-mcp is a legacy alias that also works):

formegifts-mcp auth

Source

Source: github.com/formegifts/forme.gifts.mcp. Licensed for use with the forme.gifts service — see LICENSE. Questions or feedback: feedback@forme.gifts

Available Tools

10 tools
auth_pollA

Complete the sign-in flow started by auth_start. Pass the device_code from that response. Returns signed_in (with email) once the user approves, pending if still waiting (call this tool again), or expired (start over with auth_start).

Inputs: device_code (required).

auth_startA

Start the sign-in flow. Returns a verification URL and short user code. Show both to the user, ask them to open the URL and approve, then call auth_poll with the returned device_code.

Inputs: no named parameters.

create_giftA

Create a gift inside a wishlist. Requires wishlist_id and name. Optional: description, product_link, price_min, price_max, image_urls (max 5).

Inputs: wishlist_id (required), name (required), description, product_link, +3 more.

create_wishlistB

Create a new wishlist for the signed-in user. Returns the created wishlist row.

Inputs: name (required), description, event_date.

delete_giftA

Delete a gift by id. Without confirm: true, returns a dry-run summary. Pass confirm: true to actually delete.

Inputs: id (required), confirm.

delete_wishlistA

Delete a wishlist by id. Without confirm: true, returns a dry-run summary of what would be deleted. Pass confirm: true to actually delete.

Inputs: id (required), confirm.

get_wishlistB

Fetch a single wishlist by id or name, including its gifts.

Inputs: id, name.

list_wishlistsA

List the signed-in user's wishlists with gift counts.

Inputs: no named parameters.

update_giftB

Update a gift's fields by id. At least one field besides id is required.

Inputs: id (required), name, description, product_link, +3 more.

update_wishlistA

Update a wishlist's name, description, or event_date by id. At least one field besides id is required.

Inputs: id (required), name, description, event_date.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4/5.0

    Scored across 10 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose: authentication (auth_start, auth_poll) vs. wishlist CRUD vs. gift CRUD. No two tools overlap in functionality.

    Naming Consistency5/5

    All tools follow a consistent verb_noun pattern with snake_case, e.g., create_gift, delete_wishlist. No mixing of conventions.

    Tool Count5/5

    10 tools is well-scoped for a gift management server, covering authentication, wishlist and gift operations. Not too few or too many.

    Completeness4/5

    Covers auth, wishlist CRUD, and gift create/update/delete. Missing a dedicated get_gift tool, but get_wishlist includes gifts. Minor gap for completeness.

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      OpenAPI-to-MCP example server generated with MCPForge. Demonstrates how REST APIs can be converted into production-ready MCP servers for Claude, Cursor, Windsurf, and other MCP clients.
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      An MCP server wrapping the Cursor CLI agent, enabling Claude Code and other MCP clients to delegate tasks to Cursor's AI agent for file writing, bash commands, and codebase queries.
      -
    • A
      license
      A
      quality
      D
      maintenance
      Cross-platform MCP server providing Claude Code-style plan mode via four tools (enter_plan_mode, get_plan_mode_standards, todo_write, exit_plan_mode) with soft guidance through SKILL.md.
      5
      Apache 2.0