MCP Tool Reference Critical Risk

list_invoices

List invoices with optional pagination and filtering

Part of the PayPal MCP server. Enforce policies on this tool with Intercept, the open-source MCP proxy.

WHEN AI AGENTS USE THIS TOOL

AI agents use list_invoices to initiate financial transactions through PayPal. Financial operations involve real money and are irreversible once processed. Intercept blocks financial tools by default, requiring explicit human approval with transaction-level limits to prevent unauthorised spending.

WHY ENFORCE A POLICY ON LIST_INVOICES

list_invoices moves real money. Without a policy, an autonomous agent could initiate transactions that drain accounts or exceed budgets. Intercept blocks financial tools by default, requiring human-in-the-loop approval with configurable spending limits per transaction and per time window.

RECOMMENDED POLICY

Financial tools involve real money. Block by default and require explicit human approval before enabling.

paypal.yaml
tools:
  list_invoices:
    rules:
      - action: deny
        reason: "Requires human approval"

See the full PayPal policy for all 30 tools.

DETAILS

Tool Name

list_invoices

Category

Financial

MCP Server

PayPal MCP Server

Risk Level

Critical

MORE PAYPAL TOOLS

View all 30 tools →

SIMILAR FINANCIAL TOOLS ON OTHER SERVERS

RELATED READING

FREQUENTLY ASKED QUESTIONS

What does the list_invoices tool do?

List invoices with optional pagination and filtering. It is categorised as a Financial tool in the PayPal MCP Server, which means it involves financial transactions. Block by default and require explicit approval.

How do I enforce a policy on list_invoices?

Add a rule in your Intercept YAML policy under the tools section for list_invoices. You can allow, deny, rate-limit, or validate arguments. Then run Intercept as a proxy in front of the PayPal MCP server.

What risk level is list_invoices?

list_invoices is a Financial tool with critical risk. Critical-risk tools should be blocked by default and only enabled with explicit human approval.

Can I rate-limit list_invoices?

Yes. Add a rate_limit block to the list_invoices rule in your Intercept policy. For example, setting max: 10 and window: 60 limits the tool to 10 calls per minute. Rate limits are tracked per agent session and reset automatically.

How do I block list_invoices completely?

Set action: deny in the Intercept policy for list_invoices. The AI agent will receive a policy violation error and cannot call the tool. You can also include a reason field to explain why the tool is blocked.

What MCP server provides list_invoices?

list_invoices is provided by the PayPal MCP server (paypal/paypal-mcp-server). Intercept sits as a proxy in front of this server to enforce policies before tool calls reach the server.

ENFORCE POLICIES ON PAYPAL

Open source. One binary. Zero dependencies.