Shoptegrity MCP
An MCP server that allows AI assistants to check brand ownership, trace dollar flow, verify real discounts, and find independent local sellers to promote ethical shopping.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.shopteg.com/mcpWhat you can do with it
- Help me shop Black Friday with integrity
- Find wooden toys under $30 from independent sellers
- Check my cart: AirPods, Tide pods, a Walmart gift card
- Plan Small Business Saturday in Minneapolis
Source and maintenance
Protocol and capabilities
- Server
- shoptegrity 0.7.0
- MCP protocol
- 2025-06-18
- Tools
- 14 advertised
- Resources
- 0 advertised
- Resource templates
- 0 advertised
- Prompts
- 5 advertised
{
"tools": {
"listChanged": false
},
"prompts": {
"listChanged": false
},
"resources": {
"subscribe": false,
"listChanged": false
}
}Server-provided instructions
Untrusted server output shown for inspection. It is not Koskamo guidance and is excluded from knowledge search.
Tools
14 advertised
lookup_brand — Look up a brand
Look up one brand, store or company by name: its cited parent company, ownership type, source links and, for scored brands, a Shoptegrity composite score (an opinion). Use it for a single known name. Fields without a cited source come back null and are listed as withheld. A name Shoptegrity does not have returns an error that is not a negative finding about the company.
{
"type": "object",
"title": "lookup_brandArguments",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
}
}
}{
"type": "object",
"title": "lookup_brandOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_alternatives — Find approved alternatives
List alternatives for one brand that a Shoptegrity editor approved and that have a cited basis. Returns an empty list, with a note, when none are approved yet; browse_alternatives lists cited employee-owned, cooperative and independent options by category instead. Alternatives are not ranked by commission.
{
"type": "object",
"title": "find_alternativesArguments",
"required": [
"brand_name"
],
"properties": {
"brand_name": {
"type": "string",
"title": "Brand Name"
}
}
}{
"type": "object",
"title": "find_alternativesOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}browse_alternatives — Browse cited alternatives
Alternatives to mainstream shopping that have a cited basis: employee-owned, cooperative, credit union, B Corp or family-owned sellers. structure filters by kind (for example 'employee-owned', 'cooperative', 'credit union', 'b corp'); query filters by words in the name or the category it substitutes for (for example 'grocery' or 'hardware'). Each result carries the source that backs it. Not ranked by commission.
{
"type": "object",
"title": "browse_alternativesArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"structure": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Structure",
"default": null
}
}
}{
"type": "object",
"title": "browse_alternativesOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}find_local_businesses — Find local businesses
Local businesses near a US ZIP code or a town and state, such as '55401' or 'Duluth, MN': Shoptegrity's directory (co-ops, markets, credit unions; pilot areas) plus independent shops anywhere in the US (books, gifts, toys, food, markets, grocery, hardware, clothing, secondhand, outdoors, home, music), for Small Business Saturday or any local shopping. category narrows either list; radius_km is 0.1 to 500 (default 25; shops are searched within 15). Chains and franchises are left out. Not ranked by commission.
{
"type": "object",
"title": "find_local_businessesArguments",
"required": [
"location"
],
"properties": {
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
},
"location": {
"type": "string",
"title": "Location"
},
"radius_km": {
"type": "number",
"title": "Radius Km",
"default": 25
}
}
}{
"type": "object",
"title": "find_local_businessesOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}search_top_brands — Search brand integrity database
Search the scored-brand table by name, category and minimum grade, and return a short summary per brand (parent company, shareholder payout, grade and ratings where published). Use it to browse; use lookup_brand for one known name. An empty result means no match, not a negative finding.
{
"type": "object",
"title": "search_top_brandsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"query": {
"type": "string",
"title": "Query",
"default": ""
},
"category": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Category",
"default": null
},
"min_grade": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Min Grade",
"default": null
}
}
}{
"type": "object",
"title": "search_top_brandsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}lookup_brand_integrity — Brand integrity details
In-depth cited metrics for one brand: the split of revenue among workers, executives and shareholders, labor records, and waste, plus SEC filing figures where they exist. Every field without a cited source is null and listed under withheld_claims. Grades and ratings are Shoptegrity opinions.
{
"type": "object",
"title": "lookup_brand_integrityArguments",
"required": [
"brand_name"
],
"properties": {
"brand_name": {
"type": "string",
"title": "Brand Name"
}
}
}{
"type": "object",
"title": "lookup_brand_integrityOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}rate_major_retailers — Rate major retailers
Scorecards for the major retailers Shoptegrity covers (Walmart, Target, Costco, Amazon, Kroger, Dollar General, The Home Depot, WinCo Foods, Ace Hardware): parent company, revenue, net income and shareholder payouts from SEC filings, and ratings or swaps only where an editor approved them. Takes no arguments. Missing values are null (withheld).
{
"type": "object",
"title": "rate_major_retailersArguments",
"properties": {}
}{
"type": "object",
"title": "rate_major_retailersOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}get_retailer_swaps — Retailer swaps
One major retailer's cited financial figures and any editor-approved swap. Takes a retailer name such as Walmart or The Home Depot. The swap fields are null until a swap has been approved and cited; the error lists the retailers available.
{
"type": "object",
"title": "get_retailer_swapsArguments",
"required": [
"retailer_name"
],
"properties": {
"retailer_name": {
"type": "string",
"title": "Retailer Name"
}
}
}{
"type": "object",
"title": "get_retailer_swapsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}check_seller — Check a seller
Shoptegrity's cited ownership signals for a seller or brand name, or a plain statement that it has none (not a negative finding). Same data as lookup_brand, phrased for a seller you are about to buy from.
{
"type": "object",
"title": "check_sellerArguments",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name"
}
}
}{
"type": "object",
"title": "check_sellerOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}responsible_alternatives — Find independent sellers and gifts
Search independent sellers for a product or gift idea, with today's price, a check against recorded price history, and any Shoptegrity standing, for gift ideas and holiday shopping. max_price is in USD.
{
"type": "object",
"title": "responsible_alternativesArguments",
"required": [
"product"
],
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 10
},
"product": {
"type": "string",
"title": "Product"
},
"max_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Max Price",
"default": null
}
}
}{
"type": "object",
"title": "responsible_alternativesOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}check_deal — Check a deal against price history
Judge a sale price against Shoptegrity's recorded daily price history for a Shopify catalog product. Flags 'raised_then_lowered' when a price was pushed up before a sale. Works for Black Friday and Cyber Monday deals. product_id comes from responsible_alternatives.
{
"type": "object",
"title": "check_dealArguments",
"required": [
"product_id"
],
"properties": {
"product_id": {
"type": "string",
"title": "Product Id"
},
"current_price": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"title": "Current Price",
"default": null
}
}
}{
"type": "object",
"title": "check_dealOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}holiday_shopping_guide — Holiday shopping guide
A plan for shopping with integrity on Black Friday, Small Business Saturday, Cyber Monday, Giving Tuesday or for holiday gifts: the date, days left, and which Shoptegrity tools to use at each step. occasion is black_friday, small_business_saturday, cyber_monday, giving_tuesday, christmas, or 'next' for the next one coming up. today is an ISO date and defaults to the server's date. For Black Friday, Cyber Monday and holiday gifts it also returns links to large retailers' own weekly-ad and deals pages.
{
"type": "object",
"title": "holiday_shopping_guideArguments",
"properties": {
"today": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Today",
"default": null
},
"occasion": {
"type": "string",
"title": "Occasion",
"default": "next"
}
}
}{
"type": "object",
"title": "holiday_shopping_guideOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}check_cart — Check a shopping list
Check a shopping or gift list: for each item, which scored company it belongs to (if any), the cited facts Shoptegrity holds (parent, filings, shareholder payouts) and what is withheld. Items can be products, brands or stores, such as 'AirPods', 'Tide pods' or 'Walmart'. Up to 50 items.
{
"type": "object",
"title": "check_cartArguments",
"required": [
"items"
],
"properties": {
"items": {
"type": "array",
"items": {
"type": "string"
},
"title": "Items"
}
}
}{
"type": "object",
"title": "check_cartOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}verified_deals — Verified price drops
Products from independent Shopify sellers whose price Shoptegrity recorded dropping below its usual level. Shows real drops rather than headline discounts, for Black Friday and Cyber Monday. A drop counts only with at least 7 earlier days of recorded prices; prices raised before a sale never qualify. min_percent_off is 1-90. query filters by words in the title or seller. max_per_seller (default 3) keeps one seller's sale from filling the list. Largest drop first, never ordered by commission.
{
"type": "object",
"title": "verified_dealsArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 20
},
"query": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Query",
"default": null
},
"max_per_seller": {
"type": "integer",
"title": "Max Per Seller",
"default": 3
},
"min_percent_off": {
"type": "number",
"title": "Min Percent Off",
"default": 10
}
}
}{
"type": "object",
"title": "verified_dealsOutput",
"required": [
"result"
],
"properties": {
"result": {
"type": "object",
"title": "Result",
"additionalProperties": true
}
}
}{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Prompts
5 advertised
black_friday — Black Friday with integrity
Plan Black Friday: real discounts, from sellers worth funding.
- shopping_list
- No description
- budget
- No description
small_business_saturday — Small Business Saturday near me
Find independent and member-owned businesses near you.
- town
- No description
cyber_monday — Cyber Monday deal check
Check Cyber Monday deals against price history and find independent online sellers.
- items
- No description
holiday_gifts — Holiday gift list with integrity
Build a holiday gift list from independent makers within a budget.
- people
- No description
- budget_per_person
- No description
check_my_cart — Check my cart
See who gets the money for everything on a shopping list.
- items
- No description
Resources
0 advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 1511 ms
- 95th percentile latency
- 1511 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 1511 ms · metadata changed · 14 tool(s), 0 resource(s), 0 resource template(s), 5 prompt(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport http shoptegrity-mcp https://mcp.shopteg.com/mcpCodex
codex mcp add shoptegrity-mcp --url https://mcp.shopteg.com/mcpCursor
{
"mcpServers": {
"shoptegrity-mcp": {
"url": "https://mcp.shopteg.com/mcp"
}
}
}Cline
{
"mcpServers": {
"shoptegrity-mcp": {
"type": "streamableHttp",
"url": "https://mcp.shopteg.com/mcp",
"disabled": false
}
}
}VS Code
{
"servers": {
"shoptegrity-mcp": {
"type": "http",
"url": "https://mcp.shopteg.com/mcp"
}
}
}Gemini CLI
gemini mcp add --transport http shoptegrity-mcp https://mcp.shopteg.com/mcpClaude Desktop
{
"mcpServers": {
"shoptegrity-mcp": {
"url": "https://mcp.shopteg.com/mcp"
}
}
}Windsurf
{
"mcpServers": {
"shoptegrity-mcp": {
"serverUrl": "https://mcp.shopteg.com/mcp"
}
}
}Let your agent find its tools
Find servers like Shoptegrity MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.
Other commerce servers
Do you run Shoptegrity MCP?
Prove ownership with a DNS record, a well-known file, or your Official MCP Registry entry, and your edits publish immediately. Proofs are re-checked weekly; admins can still hide or remove a listing.