scrip_. Tools that change data require Scrip permission and client approval.
Programs and reporting
| Tool | Type | Use it to |
|---|---|---|
scrip_ping | View | Confirm that the connection is active. |
scrip_get_program_overview | View | Inspect program configuration, assets, rules, and tiers. |
scrip_get_program_analytics | View | Pull activity, liability, expiration, and ledger integrity for a period. |
scrip_explain_event | View | Trace an event through rule evaluation and ledger entries. |
scrip_get_event_shapes | View | Sample recent event payloads by type and check them against the fields rules read. |
Participants and groups
| Tool | Type | Use it to |
|---|---|---|
scrip_search_participants | View | Find a participant by name, state, or filter. |
scrip_get_participant_context | View | Explain a participant, their state, and their balance. |
scrip_search_groups | View | Find a group or shared wallet. |
scrip_get_group_context | View | Explain a group, its wallet, and its state. |
scrip_adjust_balance | Change | Apply an audited credit or debit to a participant balance. |
Redemptions and rewards
| Tool | Type | Use it to |
|---|---|---|
scrip_get_rewards_catalog | View | Browse rewards, costs, status, and availability. |
scrip_list_redemptions | View | List a participant’s redemptions. |
scrip_get_redemption_context | View | Inspect redemption status, cost, ledger entry, and reversal history. |
scrip_reverse_redemption | Change | Reverse or refund a redemption. |
Rules
| Tool | Type | Use it to |
|---|---|---|
scrip_list_rules | View | Review rules in a program. |
scrip_get_rule | View | Inspect one rule. |
scrip_validate_cel | View | Check a CEL condition for syntax and common mistakes. |
scrip_test_rule | View | Simulate a draft or saved rule. Nothing is saved. |
scrip_test_run | Change | Run synthetic or historical events through a whole program’s rules. Ledger effects roll back; only the test-run record persists. |
scrip_create_or_update_rule | Change | Save a rule after validating and testing it. |
Documentation and API coverage
| Tool | Type | Use it to |
|---|---|---|
scrip_search_docs | View | Search Scrip guides, rule docs, and API reference. |
scrip_fetch_doc | View | Fetch a specific docs page. |
scrip_api_request | View or change | Call a Scrip API endpoint that does not have a dedicated MCP tool. |
scrip_search_docs before asking the model to draft rules or call unfamiliar endpoints. Use scrip_api_request only when a dedicated tool does not cover the task.
Changing data
Scrip reads by default. Change tools appear only when your Scrip connection and role allow them. Your MCP client may also ask for approval before a change tool runs. Use that approval step for actions such as saving a rule, adjusting a balance, or reversing a redemption. Scrip records changes through the same audited API paths used by the dashboard and REST API. To test a rule, usescrip_test_rule. To correct a balance, use scrip_adjust_balance.