ShopsApp MCP bridge
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| SHOPSAPP_TOKEN | No | Revocable access token (ak_...) for private access. Optional; not needed for public profile/list reads. | |
| SHOPSAPP_BASE_URL | No | Base URL of the ShopsApp JSON API. Defaults to the local origin http://127.0.0.1:5174. | http://127.0.0.1:5174 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| start_account_signupA | Start email-verified signup after the person approves sending an email. Only the person can finish; no credential is returned. |
| start_agent_pairingB | Request owner approval for this agent. Show only approval_url to the person; keep request_secret private. |
| exchange_agent_pairingA | Exchange a private pairing request secret after the person approves. Store the returned agent credential securely. |
| get_public_profileB | Read a person's public profile and public lists by alias. |
| get_public_listB | Read a public list by slug. |
| list_my_listsA | List the authenticated owner's shopping and wish lists. |
| get_listC | Read a list when the configured account or grant permits it. |
| get_my_profileA | Read the authenticated account's alias and profile URL. |
| create_listC | Create a private or public shopping/wish list for the owner. |
| capture_urlC | Save the exact URL, including existing referral attribution. |
| invite_personC | Invite a named ShopsApp user to one list. |
| list_my_invitesA | Read invitations addressed to the authenticated account. |
| accept_list_inviteC | Accept an invitation addressed to the authenticated account. |
| list_shared_with_meA | Read lists shared with the authenticated account. |
| reserve_itemB | Reserve one gift unit after the buyer chooses; does not purchase it. |
| release_reservationC | Release an abandoned gift reservation. |
| get_handoffC | Get the original saved merchant URL without rewriting it. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 17 tools
Most tools target distinct resources and actions (e.g., get_public_list vs list_my_lists vs list_shared_with_me). The only slight ambiguity is between get_list and get_public_list, but their descriptions clarify the access scope.
All tool names follow a consistent snake_case verb-first pattern, with qualifiers like my/public/shared placed before the noun (e.g., get_my_profile, list_shared_with_me, reserve_item). No mixing of conventions or styles.
17 tools is slightly above the optimal range but each tool covers a distinct action in the shopping list domain, including account and pairing operations. The set feels a bit heavy but not bloated.
The server covers core list creation/reading, sharing, and reservations, but lacks update/delete for lists, decline for invites, and explicit add/remove item operations. These gaps may require workarounds.