@formegifts/mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@@formegifts/mcp show my wishlists"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
@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/mcpClaude 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/mcpInstall 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 authIf installed globally (npm install -g @formegifts/mcp), use formegifts-mcp directly (forme-mcp is a legacy alias that also works):
formegifts-mcp authSource
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 toolsauth_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
Scored across 10 tools
Each tool has a clearly distinct purpose: authentication (auth_start, auth_poll) vs. wishlist CRUD vs. gift CRUD. No two tools overlap in functionality.
All tools follow a consistent verb_noun pattern with snake_case, e.g., create_gift, delete_wishlist. No mixing of conventions.
10 tools is well-scoped for a gift management server, covering authentication, wishlist and gift operations. Not too few or too many.
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
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Shared memory MCP server for Claude Code, Codex, Gemini CLI and Cursor. Cited, editable.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Official MCP server for Lovable, the AI-powered full-stack app builder.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server for accessing Claude Code plugins. Enables retrieving plugin lists and detailed information via MCP clients like Claude Desktop, Cursor.227 PyPIMIT
- AlicenseNot gradedqualityDmaintenanceOpenAPI-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
- FlicenseNot gradedqualityDmaintenanceAn 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.-
- AlicenseAqualityDmaintenanceCross-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.5Apache 2.0