Source-backed catalog

Tools and scopes

Every tool your assistant can use, what it does to your data, and the access it needs.

Tool catalogue

61 customer tools, checked against the Core API MCP server on 17 November 2026 (commit 7c28e3d). A session sees only the tools its sign-in or key and its toolset allow.

ReadRead-only. Never asks for permission.
ChangeAdditive or reversible. Done when asked, then reported with how to undo it.
Needs plan approvalRemoves data or moves prices. One approval covers the whole plan.

1 tool

Account channel selection

View channelsaccount credential + channels:read

List channels owned by the signed-in account or account-bound MCP key. Global operators use the separate account-channel tool below.

  • pricemind_list_channelsList my Pricemind channelsRead List channels belonging to the account bound to this credential.

7 tools

Product discovery · read

View product discoveryproduct_discovery:read

Inspect comparison context, groups, tracked runs, candidates, and comparable identities.

  • product_discovery_get_contextGet Product Discovery contextRead Read comparison definitions, owned-product groups, coverage, and recent runs for a channel.
  • product_discovery_get_groupGet an owned-product comparison groupRead Read one owned-product comparison group and its versions.
  • product_discovery_list_runsList discovery runsRead List tracked same-product discovery runs.
  • product_discovery_get_runGet same-product discovery runRead Read one tracked discovery run.
  • product_discovery_list_itemsList products in a same-product runRead List source items within a discovery run.
  • product_discovery_list_candidatesReview same-product retailer candidatesRead List retailer candidates for one run item.
  • product_discovery_get_comparableGet a comparable productRead Read a resolved comparable-product identity and its attached observations.

13 tools

Product discovery · write

Manage comparable productsproduct_discovery:write

Create and revise comparables, operate runs, and attach or detach offers in one call. Batch tools take 1–25 items. Preview tools stay review-only.

  • product_discovery_add_comparableAdd a researched comparable productChange Create or reuse a researched synthetic comparable with evidence.
  • product_discovery_link_existing_comparableLink an existing comparable productChange Assign an existing account-level comparable by definition ID without creating a duplicate.
  • product_discovery_update_comparableUpdate a researched comparable productChange Update a comparable definition with an expected version.
  • product_discovery_startStart same-product occurrence discoveryChange Start an idempotent same-product discovery run.
  • product_discovery_stopStop same-product occurrence discoveryChange Stop a tracked discovery run; completed work is kept.
  • product_discovery_preview_attachPreview attaching a comparable productRead Review only: show the exact attachment a candidate or direct request would create.
  • product_discovery_preview_detachPreview detaching a comparable productRead Review only: show the exact attachment that would be closed.
  • product_discovery_preview_remove_comparablePreview removing a comparable from an owned productRead Review only: show the comparable that would leave one group.
  • product_discovery_execute_attachAttach offer to comparison productChange Validate and attach one exact offer beneath a comparison product in one call.
  • product_discovery_execute_attach_batchAttach offers to comparison products in bulkChange Attach 1–25 exact offers in one call and return a per-item summary with how to undo.
  • product_discovery_execute_detachDetach offer from comparison productNeeds plan approval Close one exact attachment in one call; history is kept.
  • product_discovery_execute_detach_batchDetach offers from comparison products in bulkNeeds plan approval Detach 1–25 exact attachments in one call and return a per-item summary.
  • product_discovery_execute_remove_comparableRemove comparison productNeeds plan approval Remove one comparable from one group; the reusable definition is kept.

15 tools

Matching · read

View matchingmatching:read

Query normalized evidence progressively, from compact context to exact pair and signal details.

  • matching_get_contextGet matching contextRead Read compact channel state and schema/catalog versions.
  • matching_get_schemaGet matching schema and signal catalogRead Read the typed query schema, collection profiles, and signal catalog.
  • matching_list_jobsList matching jobsRead List channel matching jobs.
  • matching_get_jobGet matching jobRead Read one matching job and its state.
  • matching_list_job_runsList matching job runsRead List runs belonging to one job.
  • matching_list_runsList matching runsRead List matching runs across the channel.
  • matching_get_runGet matching runRead Read one matching run.
  • matching_query_suggestionsQuery job suggestionsRead Query authoritative suggestions for one job and optional run.
  • matching_queryQuery matching dataRead Query allowlisted matching datasets through the typed DSL.
  • matching_get_pairGet exact product pairRead Read one exact product pair with bounded expansions.
  • matching_explain_pairExplain exact product pairRead Explain one exact pair with selected evidence.
  • matching_get_signal_detailsGet exact signal detailsRead Read one exact suggestion signal.
  • matching_analyze_issuesAnalyze matching issuesRead Analyze bounded matching data-quality issues.
  • matching_list_current_matchesList current matchesRead List current channel matches.
  • matching_list_historyList matching historyRead List match, unmatch, and decision history.

2 tools

Matching · job definitions

Configure matchingmatching:write

Create or update typed matching jobs. Match decisions use the separate approval scope below.

  • matching_create_jobCreate draft matching jobChange Create a typed channel matching job. It does not start a run or match products.
  • matching_update_jobUpdate draft matching jobChange Update a matching job with concurrency safeguards.

2 tools

Matching · runs

Run matchingmatching:run

Start or stop matching computation independently from job editing and match decisions.

  • matching_start_runStart matching runChange Start a matching job run. It creates suggestions only; it never matches products.
  • matching_stop_runStop matching runChange Stop an active matching run; completed evidence and history are kept.

7 tools

Matching · decisions

Approve match changesmatching:write + matching:approve

Match or unmatch exact pairs in one call, singly or in batches of 1–25. Preview tools stay review-only. Unmatch history is always kept.

  • matching_preview_matchPreview exact matchRead Review only: show the exact proposed match.
  • matching_preview_match_batchPreview exact match batchRead Review only: validate an ordered batch of up to 25 proposed matches.
  • matching_preview_unmatchPreview exact unmatchRead Review only: show the exact current match that would be removed.
  • matching_execute_matchMatch competitor offerChange Validate and match one exact pair in one call.
  • matching_execute_match_batchMatch competitor offers in bulkChange Validate and match 1–25 exact pairs in one call.
  • matching_execute_unmatchUnmatch competitor offerNeeds plan approval Remove one exact current match in one call; account-wide effects are reported.
  • matching_execute_unmatch_batchUnmatch competitor offers in bulkNeeds plan approval Unmatch 1–25 exact pairs in one call and return a per-item summary.

4 tools

Pricing strategies · read

View pricing strategiespricing_rules:read

Read channel pricing context, the typed business schema, and immutable strategy versions.

  • pricing_strategy_get_contextGet pricing strategy contextRead Read pricing context and the current schema version.
  • pricing_strategy_get_schemaGet pricing strategy schemaRead Read typed strategy fields, catalogs, and constraints.
  • pricing_strategy_listList pricing strategiesRead List pricing strategies for a channel.
  • pricing_strategy_getGet pricing strategyRead Read one exact strategy and version.

4 tools

Pricing strategies · write

Manage pricing strategiespricing_rules:write

Create or update typed strategies in one call after one approval of the plan; material warnings return decision_required. Preview tools stay review-only.

  • pricing_strategy_preview_createPreview creating a pricing strategyRead Review only: validate a typed strategy creation and show its warnings.
  • pricing_strategy_preview_updatePreview updating a pricing strategyRead Review only: validate a version-checked strategy update and show its warnings.
  • pricing_strategy_execute_createCreate pricing strategyNeeds plan approval Validate and create a typed strategy in one call.
  • pricing_strategy_execute_updateUpdate pricing strategyNeeds plan approval Validate and apply a version-checked strategy patch in one call.

3 tools

Tracked crawls · read

View crawlscrawl:read

Inspect asynchronous crawl progress without conflating pipeline completion with product output.

  • crawl_getGet tracked crawl progressRead Read parent state and aggregate progress for one crawl request.
  • crawl_list_targetsList tracked crawl targetsRead List cursor-paginated target state, HTTP outcomes, extraction diagnostics and config fingerprint.
  • crawl_list_resultsList crawl extraction resultsRead Read typed extracted records and variants with pagination and explicit retention expiry; channel_id is optional.

1 tool

Tracked crawls · run

Run crawlscrawl:run

Start URL or small-batch crawls in one call. Omit channel_id for extraction only; saved segments require a channel.

  • crawl_startStart a tracked product-page crawlChange Start an idempotent crawl; preview=true keeps it review-only.
Pricemind internal operator tools (2)

Included for contract completeness. Customer-created MCP keys cannot receive these fixed-profile tools.

1 tool

Global account directory

Approved global operator onlymcp_global_operator + mcp:global_account_access

Search active customer accounts only when the dedicated global-operator credential profile is also valid. Ordinary and integration-bound credentials never receive this tool.

  • pricemind_search_accountsSearch Pricemind accountsRead Search the approved global account directory before listing one account's channels.

1 tool

Global account channel selection

Approved global operator onlymcp_global_operator + mcp:global_account_access + channels:read

List channels for one selected account only when the fixed global-operator credential profile and both required scopes are present.

  • pricemind_list_account_channelsList account channelsRead List channels for one selected global-directory account.

Choose capabilities by workflow

Sign-in offers Read only or Read and make changes. For a key, pick these labels in the key dialog, not raw scopes; Pricemind adds the prerequisites. A key's capabilities cannot be edited later, so include every workflow it needs now.

Products and pricesToolsetsearch

Answer questions about your products, matched competitor offers, and price history with typed search.

Start with
View channel productsproducts:read
Add if needed
View matched competitor offersInclude competitor offers, competitor price fields, and price history.
Product discoveryToolsetproduct-discovery

Research comparable products and manage comparison groups.

Start with
View product discoveryproduct_discovery:read
Add if needed
Manage comparable productsStart discovery, add or update comparables, and attach, detach, or remove them.
Product matchingToolsetmatching-analysisConfigure, run, or change matches → matching-operator

Analyze evidence, configure jobs, run matching, or change match decisions.

Start with
View matchingmatching:read
Add if needed
Configure matchingCreate or update matching jobs.
Add if needed
Run matchingStart or stop matching jobs and runs.
Add if needed
Approve match changesMatch or unmatch offers, one at a time or in batches of up to 25.
Pricing strategiesToolsetpricing-strategies

Inspect typed pricing rules and, when needed, create or update them.

Start with
View pricing strategiespricing_rules:read
Add if needed
Manage pricing strategiesCreate or update strategies after one approval of the plan; previews stay review-only.
Tracked crawlsToolsetcrawl

Inspect crawl progress and optionally start refresh work.

Start with
View crawlscrawl:read
Add if needed
Run crawlsStart URL crawls, including standalone extraction.
REST-only capabilities are separate

The MCP profile may also offer integrations, custom fields, prices, or source-run access marked REST only. Those choices do not publish MCP tools. Leave them off unless this same workload also calls the REST API; use a separate REST key when stronger isolation matters.

Toolset comparison

A toolset narrows model context; it is not an authorization boundary. Use exactly one supported value in the connection URL. Omitted or empty means all.

allAll permitted toolsGeneral agents that move between search, discovery, matching, pricing, and crawls.
product-discoveryProduct discoveryResearch and assortment-comparison workflows.
matching-analysisMatching analysisEvidence review without mutation tools in the model context.
matching-operatorMatching operatorSessions that must operate matching, not only analyze it.
pricing-strategiesPricing strategiesFocused pricing policy design and maintenance.
crawlTracked crawlsSmall-context crawl operations and diagnostics.
searchSearchPrice intelligence and reporting assistants.
Exact matching-analysis surface

With View matching, ?toolset=matching-analysis retains these ten Matching tools plus the applicable channel-selection tool. Mutation schemas never enter the session context.

matching_get_contextmatching_get_schemamatching_list_jobsmatching_get_jobmatching_list_runsmatching_get_runmatching_query_suggestionsmatching_querymatching_explain_pairmatching_get_signal_details

Technical scope reference

These scopes authorize the connection or publish customer MCP tools and resources. The app manages selectable scopes through capability labels and adds their prerequisites automatically.

Added automaticallyMCP connection accessmcp:use

Hidden from the capability checklist and included on every MCP-profile key.

Capability in appScopeAutomatically includesWhat it enables
View channelschannels:readNoneLists the channels of the credential's account.
View channel productsproducts:readView channelsSearch over your products and prices with search_get_schema and search_query.
View matched competitor offerscompetitor_prices:readView channel productsAdds matched competitor offers, competitor price fields, and price history to search.
View product discoveryproduct_discovery:readView channelsDiscovery context, groups, runs, candidates, and comparables.
Manage comparable productsproduct_discovery:writeView product discoveryDiscovery runs, comparable changes, and single or batch attach and detach.
View matchingmatching:readView channelsMatching jobs, evidence, queries, matches, and history.
Configure matchingmatching:writeView matchingCreate and update matching jobs.
Run matchingmatching:runView matchingStart and stop matching computation.
Approve match changesmatching:approveConfigure matchingMatch and unmatch exact pairs, singly or in batches.
View pricing strategiespricing_rules:readView channelsPricing context, schemas, lists, and exact strategies.
Manage pricing strategiespricing_rules:writeView pricing strategiesTyped strategy creation and updates.
View crawlscrawl:readView channelsOwned crawl requests, targets, progress and structured records.
Run crawlscrawl:runView crawlsAsynchronous URL crawling and optional standalone extraction.
Pricemind internal operator scopes

These fixed-profile permissions are shown only for contract completeness. Customer-created MCP keys cannot select them.

AudienceScopeRequiresWhat it enables
Not customer-selectablematching:read_internalApproved global-operator profileElevated lossless matching diagnostics.
Not customer-selectablemcp:global_account_accessApproved global-operator profileSearches the approved global account directory.

Workflow prompts

The default all toolset also publishes six MCP prompts with step-by-step workflows. They match the skills in the Pricemind plugin, so a client with only the connector gets the same workflows. Prompts are read-only text; the tools they use still need the matching capabilities.

weekly-review

Weekly pricing review. Last week's competitor price moves, position gained or lost, new out-of-stocks and the top 10 products to act on.

channel, period
management-report

Management pricing report. Period-over-period review: price index, position by brand and category, and competitor activity, in a fixed structure.

channel, period
promo-watch

Promotion watch. Who started cutting prices, how deep, since when, and in which categories.

channel, period
price-check

Price check for one product. One product: your price, every competitor's price and stock, price history, and match-quality warnings.

channel, product (required)
own-brand-vs-market

Own brand vs market. Own-brand products against the cheapest comparable branded product, on channels with product groups.

channel, period
setup

Set up Pricemind. Check the connection, pick a channel, explain what Pricemind can do, and suggest three first questions.

channel

Resource templates

Resources provide reusable channel context and versioned schemas. A template appears only when the key has its read capability and the selected toolset includes that family.

pricemind://channels/{channel_id}/product-discovery

Product discovery context for one authorized channel.

product_discovery:read
pricemind://channels/{channel_id}/matching

Compact matching context for one authorized channel.

matching:read
pricemind://channels/{channel_id}/matching/schema

Versioned typed query schema and signal catalog.

matching:read
pricemind://channels/{channel_id}/pricing-strategies

Pricing-strategy context for one authorized channel.

pricing_rules:read
pricemind://channels/{channel_id}/pricing-strategies/schema

Versioned typed pricing-strategy business schema.

pricing_rules:read

Write safety model

ReadsNever ask. The agent reads whatever the question needs. Search, context, schemas, previews, lists, and explanations.
Additive or reversible changesDone when you ask for them, then reported with what changed and how to undo it. Match, attach, add a comparable, start a crawl or a run.
Removals and price-moving changesOne approval for the whole plan, then the agent runs it to the end without further questions. Unmatch, detach, remove a comparable, create or update a pricing strategy.
The only mid-job stopA material warning, a changed version, a wider scope, or a missing permission. Nothing was changed; the agent reports the reason and asks once. The server answers decision_required.
One-call execute toolsEvery *_execute_* tool takes intent (the exact operation), a stable idempotency_key, and optional acknowledgements for warning codes the user's authorization already covers. The server validates and applies the intent in the same call.
Batch toolsmatching_execute_match_batch, matching_execute_unmatch_batch, product_discovery_execute_attach_batch, and product_discovery_execute_detach_batch take 1–25 items and report each item as executed, already applied, needs a decision, failed, unverified, or not attempted, plus how to undo. A retry with the same key never repeats an item that already ran.
Matching decisionsMatch and unmatch tools require both matching:write and matching:approve. Unmatch history is always kept.
Pricing strategiesExecution preserves typed schemas, warning acknowledgements, and optimistic versions; unacknowledged material warnings return decision_required.
Tracked crawlscrawl_start starts work in one call. Use preview: true for review. Omit channel_id for standalone extraction and retrieve typed records with crawl_list_results.
Other writesComparable add/update, discovery start/stop, matching job changes, and matching run control run directly with idempotency or concurrency safeguards.
Retry-safe intentNever reuse an idempotency key for changed intent. A retry with the same key replays the original result instead of repeating the change.
Automatic execution is not human confirmation

Changes are audited as authorized execution. decision_required—a material warning, a changed version, a wider scope, or a missing permission—is the only mid-job stop, and nothing was changed. Approval prompts shown by your MCP client remain independent.

Contract notes

  • Channel-scoped tools use channel_id as the authorization anchor and do not accept arbitrary account selectors.
  • New product contracts use product_domain_id; deprecated product_id, SQL, and arbitrary table names are not MCP inputs.
  • Matching queries use a typed, allowlisted DSL. Exact pair reads support bounded expansions and selected response paths.
  • Pricing strategy input is typed and closed. Protected integration credentials and arbitrary owner payloads are never exposed.
  • Crawl selectors accept exactly one URL, a direct batch of at most 100 targets, or an authorized saved segment.
  • Search accepts a typed query body only: datasets and field names come from search_get_schema; SQL text and table names are rejected.