Skip to main content
Glama
freddy-jay

bring-mcp

by freddy-jay
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
BRING_LISTNoDefault list name or uuid to use when the list argument is omitted
BRING_EMAILYesBring! account email
BRING_PASSWORDNoBring! account password (required if not using the OS credential store)
BRING_HTTP_HOSTNoserve-http bind address (default: 0.0.0.0)
BRING_HTTP_PATHNoserve-http path (default: /mcp)
BRING_HTTP_PORTNoserve-http port (default: 8080)
BRING_HTTP_TOKENNoBearer token required when using serve-http (optional)
BRING_MCP_LOG_LEVELNoLog level: DEBUG, INFO, WARNING, or ERROR (logged to stderr)
BRING_KEYRING_SERVICENoCredential store service name (default: bring-mcp)

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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_listsA

List every Bring! shopping list on the account, with its uuid and name.

get_list_itemsA

Get the items on a shopping list.

Args:
    list: List name or uuid. Omit to use the BRING_LIST default.

Returns items still to buy plus recently purchased ones. Each item carries a
`uuid` that can be passed back to `remove_item` or `complete_item` to target
that exact item when several share a name.
add_itemA

Add an item to a shopping list, or update the note on an existing one.

Args:
    item: Item name, e.g. "Milk".
    specification: Optional note such as a quantity or brand, e.g. "2 litres".
    list: List name or uuid. Omit to use the BRING_LIST default.
remove_itemA

Delete an item from a shopping list without marking it as purchased.

Args:
    item: Item name, e.g. "Milk".
    list: List name or uuid. Omit to use the BRING_LIST default.
    item_uuid: Optional item uuid from `get_list_items`, to pick one of
        several items sharing a name. Without it the oldest match is removed.
complete_itemA

Tick an item off as purchased, moving it to the recently-bought section.

Args:
    item: Item name, e.g. "Milk".
    list: List name or uuid. Omit to use the BRING_LIST default.
    item_uuid: Optional item uuid from `get_list_items`, to pick one of
        several items sharing a name.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A4.3/5.0

Scored across 5 tools

Disambiguation5/5

Each tool targets a distinct resource and action: listing lists, reading items, adding/removing/completing items. The remove vs complete distinction is clearly explained, and the optional uuid parameter resolves ambiguity for duplicate item names.

Naming Consistency5/5

All tools follow a clean verb_noun pattern in snake_case: get_lists, get_list_items, add_item, remove_item, complete_item. The conventions are uniform and predictable.

Tool Count5/5

Five tools is a well-scoped set for a shopping list MCP server, covering the essential read and write operations without unnecessary bloat.

Completeness4/5

Core item workflows are covered: read lists, read items, add, remove, and complete. The main gap is lack of list creation/deletion or renaming, but this is a minor omission if the server assumes existing lists in a Bring! account.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Resources