Skip to main content

QuotaPath MCP: available tools

Every read-only tool the QuotaPath MCP gives Claude, ChatGPT and Gemini, what each returns and known issues.

The QuotaPath MCP gives Claude, ChatGPT and Gemini a set of tools: specific, read-only requests your AI assistant can make to your QuotaPath workspace. You don't call these yourself. Ask your question in plain language, and the assistant picks the right tools.

This page lists every tool available today, so you know what the assistant can and can't see. Not connected yet? Start with Setting up the QuotaPath MCP.

All tools are read-only. None of them can change anything in your QuotaPath workspace.


Plans and configuration

Tool

What it returns

Ask things like

list_plans

All plans in the workspace

"What plans do we have, and which are active?"

get_plan

Details of a single plan: description, components, rates and tiers, accelerators, quota setup, draws, and folder

"Explain the Enterprise AE plan in plain language."

list_plan_assignments

Who is assigned to which plan, and when

"Who's on the SDR plan this year?"

get_plan_mappings

Which deal fields a plan uses, its filters (which deals count) and payout eligibility rules

"Which deals count toward the AE plan, and why?"

list_workspace_mappings

How your CRM fields map to QuotaPath fields across the workspace

"Which CRM field do we use for deal amount?"

get_calculated_fields

Calculated fields (formulas your admins write) and computed fields (built by QuotaPath), with each formula and which mappings use it

"Which calculated fields do we have, and which mappings use them?"

Name check: mapping fields the MCP calls custom fields appear as Additional Fields in the QuotaPath app.

People and teams

Tool

What it returns

Ask things like

list_members

Workspace members, with role and status

"List everyone in the workspace who isn't assigned to a plan."

list_teams

Teams and their members

"Who's on the West team?"

Quota and attainment

Tool

What it returns

Ask things like

list_attainment

How each deal contributed to the fields a plan measures, in that field's own unit. This is not a percent of quota.

"Show attainment for every AE this quarter."

get_attainment_summary

Closed-won progress against quota, grouped by plan, then quota, then component. A quota shared by several components is counted once.

"How is the team tracking against quota this quarter?"

Earnings and draws

Tool

What it returns

Ask things like

list_earnings

Earnings by rep, plan and period with payout eligibility

"What did each rep earn last month?"

get_earnings_summary

Commission, draws, and their sum for one person, one plan, or both, split by deal state. This is not a team total, and the states are not combined into one number.

"Total commission earned by team this quarter?"

get_deal_earnings

Earnings on a single deal, with an explanation of how the amount was calculated (rate, tier, accelerator, override, payout eligibility)

"Explain how the commission on the Acme deal was calculated."

list_draws

Draw rows for one person, one plan, or both. The current quarter is the default.

"Who has an outstanding draw balance?"

Payouts

Admin only: the payout tools are available to workspace admins.

Tool

What it returns

Ask things like

list_payouts

Payout records by rep or plan: what was earned, paid and still owed, with each payout's date, amount and status. Can be narrowed to owed, eligible, clawback, paid or settled

"Who are we still owing commission to?" or "Show clawbacks on retired plans."

get_payout_summary

Payout totals for a person, plan or the whole workspace: owed, clawback, eligible now and paid

"How much did we pay out in March?"

Tip: payout views default to this quarter. For "what's outstanding overall," ask for all time.

Helper

Tool

What it does

get_server_instructions

Gives the assistant QuotaPath-specific guidance on using the tools. You'll never need to ask for it.

Remember: Ask your question in plain language, and the AI assistant picks the right tools. You don't need to dictate which tools to use.


Not available yet

  • Payout approvals: approval status isn't available. You can see what was earned, owed and paid, but not where a payout sits in an approval workflow.

  • Deal and CRM source data beyond what earnings and attainment use.

  • Making changes: creating or editing plans, quotas, deals or teams. Write access is next on our roadmap.

Known issues (as of Oct. 6 launch)

  • get_deal_earnings on roll-up deals: asking about a single deal that credits a manager through a roll-up can return the rep's row instead of the manager's. Totals from list_earnings and get_earnings_summary are correct. A fix is in progress.

  • Open deals show $0 earnings. This matches the app until you run "Forecast All Pipeline". You can include specific open deals in a forecast with list_earnings, get_earnings_summary, get_attainment_summary, or get_deal_earnings. A deal that is not open cannot be included. list_attainment and list_draws do not forecast.

  • Overridden deals: on a deal with an earnings override, the per-component breakdown can show the pre-override amounts. The deal total is correct.

  • Very large plan-assignment lists can be cut short in big workspaces. Ask about one plan or team at a time.

  • $0 instead of "not on this plan": asking for someone's earnings on a plan they aren't assigned to returns $0. And where a plan has no target set, quota shows as 0.

Related articles

Did this answer your question?