Koskamo

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.

Shoptegrity MCP logo, by ShoptegrityVendor evidenceStreamable HTTPNo sign-inEndpoint checked 2026-11-01Operated by Shoptegrity
MCP endpoint (Streamable HTTP)
https://mcp.shopteg.com/mcp
Vendor documentation

What 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

Vendor evidenceRegistry 0.7.0

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
Server-advertised capabilities
{
  "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.

Shoptegrity provides ownership, integrity and local-alternative information. Values are returned only when they have a cited source; a null field means withheld, not unknown, and 'Withheld: no cited source yet' is not a negative finding. Results show price alongside who owns the business, whether it is local, independent or member-owned, and the cited records behind each claim. Grades, tiers and ratings are Shoptegrity opinions under the published methodology (/methodology), not measurements. Holiday tools: holiday_shopping_guide gives dates and a plan, check_cart looks up each item on a list, responsible_alternatives searches independent sellers, check_deal compares a sale price with recorded history, and verified_deals lists recorded price drops. About Shoptegrity: it pledges 20% of its profit to five charities, listed at https://shopteg.com/giving.

Tools

14 advertised

lookup_brand — Look up a brand
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

lookup_brand input schema
{
  "type": "object",
  "title": "lookup_brandArguments",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "title": "Name"
    }
  }
}
lookup_brand output schema
{
  "type": "object",
  "title": "lookup_brandOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
lookup_brand annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
find_alternatives — Find approved alternatives
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

find_alternatives input schema
{
  "type": "object",
  "title": "find_alternativesArguments",
  "required": [
    "brand_name"
  ],
  "properties": {
    "brand_name": {
      "type": "string",
      "title": "Brand Name"
    }
  }
}
find_alternatives output schema
{
  "type": "object",
  "title": "find_alternativesOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
find_alternatives annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
browse_alternatives — Browse cited alternatives
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

browse_alternatives input schema
{
  "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
    }
  }
}
browse_alternatives output schema
{
  "type": "object",
  "title": "browse_alternativesOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
browse_alternatives annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
find_local_businesses — Find local businesses
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

find_local_businesses input schema
{
  "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
    }
  }
}
find_local_businesses output schema
{
  "type": "object",
  "title": "find_local_businessesOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
find_local_businesses annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
search_top_brands — Search brand integrity database
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

search_top_brands input schema
{
  "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
    }
  }
}
search_top_brands output schema
{
  "type": "object",
  "title": "search_top_brandsOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
search_top_brands annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
lookup_brand_integrity — Brand integrity details
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

lookup_brand_integrity input schema
{
  "type": "object",
  "title": "lookup_brand_integrityArguments",
  "required": [
    "brand_name"
  ],
  "properties": {
    "brand_name": {
      "type": "string",
      "title": "Brand Name"
    }
  }
}
lookup_brand_integrity output schema
{
  "type": "object",
  "title": "lookup_brand_integrityOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
lookup_brand_integrity annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
rate_major_retailers — Rate major retailers
Advertised by the server during the last successful anonymous check.
Advertised read-only

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).

rate_major_retailers input schema
{
  "type": "object",
  "title": "rate_major_retailersArguments",
  "properties": {}
}
rate_major_retailers output schema
{
  "type": "object",
  "title": "rate_major_retailersOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
rate_major_retailers annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
get_retailer_swaps — Retailer swaps
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

get_retailer_swaps input schema
{
  "type": "object",
  "title": "get_retailer_swapsArguments",
  "required": [
    "retailer_name"
  ],
  "properties": {
    "retailer_name": {
      "type": "string",
      "title": "Retailer Name"
    }
  }
}
get_retailer_swaps output schema
{
  "type": "object",
  "title": "get_retailer_swapsOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
get_retailer_swaps annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
check_seller — Check a seller
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

check_seller input schema
{
  "type": "object",
  "title": "check_sellerArguments",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "title": "Name"
    }
  }
}
check_seller output schema
{
  "type": "object",
  "title": "check_sellerOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
check_seller annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
responsible_alternatives — Find independent sellers and gifts
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

responsible_alternatives input schema
{
  "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
    }
  }
}
responsible_alternatives output schema
{
  "type": "object",
  "title": "responsible_alternativesOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
responsible_alternatives annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
check_deal — Check a deal against price history
Advertised by the server during the last successful anonymous check.
Advertised read-onlyOpen-world

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.

check_deal input schema
{
  "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
    }
  }
}
check_deal output schema
{
  "type": "object",
  "title": "check_dealOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
check_deal annotations
{
  "readOnlyHint": true,
  "openWorldHint": true,
  "idempotentHint": true,
  "destructiveHint": false
}
holiday_shopping_guide — Holiday shopping guide
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

holiday_shopping_guide input schema
{
  "type": "object",
  "title": "holiday_shopping_guideArguments",
  "properties": {
    "today": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Today",
      "default": null
    },
    "occasion": {
      "type": "string",
      "title": "Occasion",
      "default": "next"
    }
  }
}
holiday_shopping_guide output schema
{
  "type": "object",
  "title": "holiday_shopping_guideOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
holiday_shopping_guide annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
check_cart — Check a shopping list
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

check_cart input schema
{
  "type": "object",
  "title": "check_cartArguments",
  "required": [
    "items"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "title": "Items"
    }
  }
}
check_cart output schema
{
  "type": "object",
  "title": "check_cartOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
check_cart annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}
verified_deals — Verified price drops
Advertised by the server during the last successful anonymous check.
Advertised read-only

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.

verified_deals input schema
{
  "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
    }
  }
}
verified_deals output schema
{
  "type": "object",
  "title": "verified_dealsOutput",
  "required": [
    "result"
  ],
  "properties": {
    "result": {
      "type": "object",
      "title": "Result",
      "additionalProperties": true
    }
  }
}
verified_deals annotations
{
  "readOnlyHint": true,
  "openWorldHint": false,
  "idempotentHint": true,
  "destructiveHint": false
}

Prompts

5 advertised

black_friday — Black Friday with integrity

Advertised by the server during the last successful anonymous check.

Plan Black Friday: real discounts, from sellers worth funding.

shopping_list
No description
budget
No description
small_business_saturday — Small Business Saturday near me

Advertised by the server during the last successful anonymous check.

Find independent and member-owned businesses near you.

town
No description
cyber_monday — Cyber Monday deal check

Advertised by the server during the last successful anonymous check.

Check Cyber Monday deals against price history and find independent online sellers.

items
No description
holiday_gifts — Holiday gift list with integrity

Advertised by the server during the last successful anonymous check.

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

Advertised by the server during the last successful anonymous check.

See who gets the money for everything on a shopping list.

items
No description

Resources

0 advertised

No resource definitions available.

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.

This server is operated by the named third party. Listing and endpoint checks are not an endorsement or a security audit. Review the operator's permissions, terms, and data handling before connecting. How listings are checked and corrected.

Claude Code

Run this once in a terminal. It registers the remote server. Use --scope project to write .mcp.json for the repo.
Claude Code configuration
claude mcp add --transport http shoptegrity-mcp https://mcp.shopteg.com/mcp

Codex

Run this once. Codex stores MCP servers in ~/.codex/config.toml (or .codex/config.toml in a trusted project).
Codex configuration
codex mcp add shoptegrity-mcp --url https://mcp.shopteg.com/mcp

Cursor

Merge this server into .cursor/mcp.json in your project, then enable shoptegrity-mcp in your MCP settings.
Cursor configuration
{
  "mcpServers": {
    "shoptegrity-mcp": {
      "url": "https://mcp.shopteg.com/mcp"
    }
  }
}

Cline

Merge this into cline_mcp_settings.json (Cline → MCP Servers → Configure).
Cline configuration
{
  "mcpServers": {
    "shoptegrity-mcp": {
      "type": "streamableHttp",
      "url": "https://mcp.shopteg.com/mcp",
      "disabled": false
    }
  }
}

VS Code

Merge this server into .vscode/mcp.json. Use MCP: List Servers to start shoptegrity-mcp and inspect its tools.
VS Code configuration
{
  "servers": {
    "shoptegrity-mcp": {
      "type": "http",
      "url": "https://mcp.shopteg.com/mcp"
    }
  }
}

Gemini CLI

Run this once. It writes .gemini/settings.json in the current project; pass --scope user for ~/.gemini/settings.json.
Gemini CLI configuration
gemini mcp add --transport http shoptegrity-mcp https://mcp.shopteg.com/mcp

Claude Desktop

Merge this into claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\), then restart Claude Desktop.
Claude Desktop configuration
{
  "mcpServers": {
    "shoptegrity-mcp": {
      "url": "https://mcp.shopteg.com/mcp"
    }
  }
}

Windsurf

Merge this into ~/.codeium/windsurf/mcp_config.json, then refresh MCP in Cascade. Windsurf remote servers use serverUrl, not url.
Windsurf configuration
{
  "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.

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.

Claim this listing