Pebbler MCP
OfficialServer Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| PEBBLER_STATE_DIR | No | Folder for the connector's private local state. Use the same folder when returning to existing tests. | |
| PEBBLER_ALLOW_PAYMENTS | No | Set to "true" when you want the agent to make purchases. Payments stay disabled until enabled explicitly. | |
| PEBBLER_MAX_TOTAL_USDC | No | Your chosen cumulative spending limit, as a positive decimal USDC amount. Required when payments are enabled. | |
| PEBBLER_MAX_PURCHASE_USDC | No | Your chosen maximum spend per test, as a positive decimal USDC amount. Required when payments are enabled. | |
| PEBBLER_WALLET_PRIVATE_KEY | No | Your wallet's signing key, supplied privately. Required when payments are enabled. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_catalogA | Read supported image comparison format, price, respondent slots and schemas. Free; use before creating a study. |
| create_studyA | Validate an immutable preference comparison with two HTTPS image options. Version 1 supports A vs B image tests only. Free. Reuse request_key to recover a failed creation. Returns the study ID and quote; access credentials stay in the local adapter. |
| quote_studyA | Refresh an unpaid study's quote. Free. Do not refresh after signing a payment; recover that purchase instead. |
| purchase_studyA | Purchase and schedule the quoted study using the locally configured wallet. Charges USDC, subject to code-enforced budgets. Reuse the original idempotency_key on every retry. Pending payment/launch responses must be recovered through this same tool without another payment. |
| get_study_statusA | Get order state and collection progress. Free; honour poll_after_seconds. For pending settlement or launch, retry purchase_study with its original identifiers. |
| get_study_resultsA | Retrieve aggregate image preference votes. Free and included in purchase. Responses are from incentivised Pebbler app participants and may be incomplete. |
| list_local_studiesA | List study IDs and purchase identifiers retained by this adapter. Free; use to recover work after restarting. Does not expose wallet keys or access credentials. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool maps to a clearly distinct lifecycle step: catalog discovery, study creation, quote refresh, local recovery, purchase, status polling, and results retrieval. Descriptions explicitly differentiate overlapping terms like quote vs. create and status vs. results.
All tool names follow a predictable snake_case verb_noun pattern (get_catalog, create_study, list_local_studies, purchase_study, etc.). The convention is consistent and readable throughout.
Seven tools appropriately cover the full workflow from format discovery through purchase, status tracking, and results retrieval, plus local recovery. No tool feels redundant or missing for the core scope.
The toolset covers the full study lifecycle: discovery, creation, quoting, purchase, status polling, results, and local recovery. Minor gaps exist for cancellation/refund or explicit study metadata retrieval, though immutability and the payment model may make these out of scope.