Testimonial.to MCP Server & CLI

Q: Does login or doctor authenticate automatically?

login only prints setup instructions; doctor checks local settings. Explicit doctor --network requests GET /verify and prints success metadata without native email/id. It does not create keys, sign in, import cookies, verify every endpoint or send email.

One open source package with 10 shared tasks for Space testimonials, consent-aware imports, reviewed emails and private bounded exports.

Star on GitHub

npm

by Navid Moazzez·Updated 3 okt 2026·32 min read·

MCP CLI

Your computer

macOS Windows Linux

Add it with a single command in a terminal.

claude mcp add testimonial \
  -e TESTIMONIAL_TOKEN_FILE=/absolute/private/testimonial.txt \
  -- npx -y @thenavidm/testimonial-mcp-cli

2
In Claude Code, type /mcp. Testimonial.to should show as connected.
```
/mcp
```

Node 22+ for manual setup. Use the intended private Space REST key or token file. Native plan, customer consent and email permissions remain separate.

It's free and open source. If it saves you time, star it on GitHub, so more people find it.

Rate this tool

This free Testimonial.to MCP server and CLI connects your AI to the customer proof in the Space you choose. Read ready testimonials, import authorized text/video, review exact request emails and save a bounded private export.

The same tasks work as local MCP tools for Codex and compatible clients or CLI commands for agents and scripts. Testimonial's official MCP already covers wider proof, analytics and automation; this is a focused REST companion with documented local workflows.

key_takeaways.md

TL;DR

Key takeaways

One open source package supplies 10 shared tasks with 5 reads and 5 confirmed effect/file operations.

Private Space profiles each use an independent Bearer key or token-only file without global fallback.

Local approval and native customer public-use consent are separate, false-default fields with explicit publication checks.

Email request GET calls are confirmed writes; exact local previews never send messages or establish customer permission.

Private exports save one bounded array, with no invented pagination, complete backup or media download.

Official tools are credited and actual matched Codex task/token gains remain unmeasured.

What is the Testimonial.to MCP server & CLI?

It is one Node package with a task CLI, local stdio MCP and desktop bundle. Both surfaces use the same native schemas, private Space selection and approval handler. Five selected documented REST operations are covered; the broader official hosted MCP remains a separate option.

Try asking
Read five ready text testimonials from the Space profile I selected.
Inspect the native import schema without submitting customer proof.
Review these exact authorized imports with customer permission kept separate from local approval.
Save one bounded private testimonial array to a new file without echoing records into chat.
Review the recipient, product and signature before proposing the email request I asked for.

Testimonials and emails

list_testimonials

What it does: Read one native JSON array.
Kind: Read/helper

submit_text_testimonial

What it does: Import a real authorized customer statement.
Kind: Confirmed operation

submit_video_testimonial

What it does: Import a real publicly accessible authorized video.
Kind: Confirmed operation

send_testimonial_request

What it does: Side-effecting GET sends a real request email.
Kind: Confirmed operation

Tool	What it does	Kind
`list_testimonials`	Read one native JSON array.	Read/helper
`submit_text_testimonial`	Import a real authorized customer statement.	Confirmed operation
`submit_video_testimonial`	Import a real publicly accessible authorized video.	Confirmed operation
`send_testimonial_request`	Side-effecting GET sends a real request email.	Confirmed operation

Space verification

verify_space

What it does: Explicit native key verification.
Kind: Read/helper

Tool	What it does	Kind
`verify_space`	Explicit native key verification.	Read/helper

Private local workflows

list_accounts

What it does: Local profile labels/default/auth method only.
Kind: Read/helper

get_operation_schema

What it does: Local reviewed method/path/query/body schema and provenance for one native tool.
Kind: Read/helper

preview_testimonial_batch

What it does: Local validation and SHA-256 of exact ordered text/video import/email work, selected profile label and reviewed schema.
Kind: Read/helper

submit_testimonial_batch

What it does: Confirmed one-to-twenty ordered text/video import/email tasks.
Kind: Confirmed operation

export_testimonials

What it does: Confirmed single native GET saved to a new exclusive mode 0600 JSON file, default limit 100/local maximum 10,000 and 5 MiB response/file cap.
Kind: Confirmed operation

Tool	What it does	Kind
`list_accounts`	Local profile labels/default/auth method only.	Read/helper
`get_operation_schema`	Local reviewed method/path/query/body schema and provenance for one native tool.	Read/helper
`preview_testimonial_batch`	Local validation and SHA-256 of exact ordered text/video import/email work, selected profile label and reviewed schema.	Read/helper
`submit_testimonial_batch`	Confirmed one-to-twenty ordered text/video import/email tasks.	Confirmed operation
`export_testimonials`	Confirmed single native GET saved to a new exclusive mode 0600 JSON file, default limit 100/local maximum 10,000 and 5 MiB response/file cap.	Confirmed operation

Install and connect

One package contains 10 shared tools, both named binaries and a bundled desktop extension. Node 22+ is required.

Requirements

Install Node and verify node --version/npm --version in your actual runtime. Windows may require npm.cmd if PowerShell policy blocks npm.ps1. Do not weaken execution policy or use sudo. GUI, container and remote settings are independent.

CLI

bash
npm install -g @thenavidm/testimonial-mcp-cli@latest
testimonial-cli --version
testimonial-cli tools
testimonial-cli login

Alternatively use npx -y --package @thenavidm/testimonial-mcp-cli@latest testimonial-cli tools. Make the shipped SKILL.md available in the supported private agent skill location; npm does not register skills automatically.

Private Space setup

Select the intended Space

Sign into Testimonial.to and identify the Space whose proof you intend to read or import. Each REST API key belongs to one Space. It does not select another Space through spaceId, nor does it inherit a browser session.
On the dashboard Space card, open its three-dot menu and choose API key, then Copy API Key. The current REST list documentation specifies Ultimate and Ultimate+ per Space; Free/Starter API Key controls require an upgrade. Verify the current plan and access in your own account. The wrapper grants no plan bypass.
Configure exactly one of TESTIMONIAL_API_KEY or TESTIMONIAL_TOKEN_FILE in the private process settings. The client sends Authorization: Bearer. Do not include the word Bearer in the value, use your password, or copy a hosted MCP access-token URL as a Space key.
Token files must be absolute, regular, non-symlink, token-only files outside repositories, at most 64 KiB. On macOS/Linux the file must be owned by your runtime user and mode 0600; restrict its parent directory too. Windows users must restrict file and directory ACLs separately. GUI apps, containers and remote machines need readable private credentials in their own runtime.
Run testimonial-cli doctor to inspect local profile configuration. Deliberate doctor --network calls GET /verify but prints success metadata without echoing the native account email or Space id. It proves one key request, not ownership, all tool permission, successful media processing or delivered email.

login prints these instructions only. The package never loads .env files, opens sign-in, creates or rotates keys, imports cookies or refreshes OAuth. Do not put credentials or customer statements in public issues, screenshots, repositories, prompts or exported public examples.

Separate profiles and revocation

TESTIMONIAL_ACCOUNTS is a private JSON array of unique {name,api_key,token_file} profiles. Configure one credential source per profile. TESTIMONIAL_DEFAULT_ACCOUNT selects the default label; --account selects an exact label. An incomplete named profile never falls back to a global key, another Space or hosted connection. list_accounts shows labels/default/auth/source, without keys, file paths or provider identity.

Token files cache until process restart. Update private credentials and restart every dependent process when replacing them. Remove/revoke the intended Space key through the provider's current account controls, and verify revocation deliberately. The reviewed key guide documents copying, not a guaranteed rotation button or grace period, so neither is invented here. Hosted MCP authorization is separate. Removing a package or connection never removes saved files, retracts published proof or unsends a request email.

Native effects and local limits

The REST subset is five documented operations. Native list returns a single array; there is no page, offset or cursor. Only processed ready videos are returned. Repeated tag query values match any listed display name. limit is a result cap. The local maximum 10,000 is an implementation bound, not a documented native quota.

All imports, side-effecting GET request emails, reviewed execution and file exports require local confirm. Native customer permission is customer_consent or payload.confirm, independently defaulting false. isLiked adds proof to the Wall of Love and is refused locally unless actual native customer consent is true. This stricter local policy does not create or verify permission. Retain actual authorization for the statement/media and public use; never manufacture it to get a command to pass.

Requests are spaced 250 ms by default with a 30-second timeout, 1 MiB bodies and 5 MiB responses. Other processes may share native limits. Redirects and retries are disabled. The provider may retrieve the supplied media URL and process video asynchronously; the package does not download/follow it. A failed write can have an unknown outcome. Inspect provider state before a deliberate repeat.

Codex

Codex is the current validation priority. Private token paths must exist in the process or remote environment where the server runs.

bash
codex mcp add testimonial -- npx -y @thenavidm/testimonial-mcp-cli@latest
codex mcp list

Account credentials must reach the server through private environment settings. codex mcp add --env NAME=value stores values in your local config, so never commit that config or put secrets in a shared command. In TOML, the equivalent server is:

toml
[mcp_servers.testimonial]
command = "npx"
args = ["-y", "@thenavidm/testimonial-mcp-cli@latest"]
env_vars = ["TESTIMONIAL_API_KEY", "TESTIMONIAL_TOKEN_FILE", "TESTIMONIAL_ACCOUNTS", "TESTIMONIAL_DEFAULT_ACCOUNT", "TESTIMONIAL_READ_ONLY", "TESTIMONIAL_ALLOW_DESTRUCTIVE"]

env_vars forwards those names from the environment available to Codex. If that environment does not contain them, configure private env settings locally. Codex can also call the CLI directly with SKILL.md and --agent output.

Claude Code

For a user-scoped connection, after privately configuring credentials:

bash
claude mcp add --scope user testimonial -- npx -y @thenavidm/testimonial-mcp-cli@latest
claude mcp list

Use the client's private local environment settings for the account variable if they are not inherited. Claude's -e NAME=value registration option writes values into its config; only use it locally through your secret manager, with no shared command transcript. Never place credentials in a project .mcp.json. Reconnect and ask Claude to verify credentials.

Alternatively install the CLI, make SKILL.md available to Claude, and use shell commands. Registering both surfaces is optional.

Claude Desktop

Install the .mcpb extension

Download testimonial-2.0.1.mcpb from GitHub Releases.
In a supported Claude Desktop build, open Settings > Extensions > Advanced settings > Install Extension… and select it.
Enter a private Space API key in the sensitive setting, OR an absolute private token-only file path. Leave the unused method empty. Requests use Authorization: Bearer. Named profiles require private manual runtime settings.
Enable read-only if you want only the 5 read operations. Reconnect and verify the intended Space with one deliberate read.

The bundle includes production dependencies and no credentials. Use a regular private token-only file if you prefer file-based credentials. The manifest requires Node 22 or newer from a compatible host. Organization policy may restrict custom extensions. Manual bundle updates require installing the new version; no automatic directory updates are promised. GUI installation remains unverified separately from archive/protocol checks.

Manual config

Open Settings > Developer > Edit Config, or use your platform's config file:

OS	Typical config path
macOS	`~/Library/Application Support/Claude/claude_desktop_config.json`
Windows	`%APPDATA%\Claude\claude_desktop_config.json`
Linux	`~/.config/Claude/claude_desktop_config.json`; confirm the location through Edit Config in your installed build

json
{
  "mcpServers": {
    "testimonial": {
      "command": "npx",
      "args": ["-y", "@thenavidm/testimonial-mcp-cli@latest"],
      "env": {
        "TESTIMONIAL_API_KEY": "YOUR_PRIVATE_API_KEY",
        "TESTIMONIAL_TOKEN_FILE": ""
      }
    }
  }
}

Replace the placeholders only in your private file. Merge the server entry into an existing mcpServers object instead of replacing other integrations. Fully quit and reopen Claude Desktop. Do not enable an extension and a manual entry with the same name; choose one route.

If a Windows launcher cannot execute npx directly, use "command": "cmd" with "args": ["/c", "npx", "-y", "@thenavidm/testimonial-mcp-cli@latest"]. An absolute node executable and installed dist/index.js path also avoids launcher/PATH problems.

Cursor

Use private user settings at ~/.cursor/mcp.json, or Settings > Tools & MCP. Cursor documents environment interpolation and envFile support.

json
{
  "mcpServers": {
    "testimonial": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@thenavidm/testimonial-mcp-cli@latest"],
      "env": {
        "TESTIMONIAL_API_KEY": "${env:TESTIMONIAL_API_KEY}",
        "TESTIMONIAL_TOKEN_FILE": "${env:TESTIMONIAL_TOKEN_FILE}"
      }
    }
  }
}

The environment values must exist for the Cursor process. If you use envFile, keep that file private and outside version control. A Space's .cursor/mcp.json must not contain actual credentials. Reconnect the server after saving.

VS Code and Copilot

Use MCP: Open User Configuration. VS Code uses servers and secure inputs, rather than a mcpServers root:

json
{
  "inputs": [
    {"type": "promptString", "id": "testimonial-api-token", "description": "Testimonial.to API key (leave empty for a private token file)", "password": true},
    {"type": "promptString", "id": "testimonial-token-file", "description": "Optional private token-file path (leave empty for API key)"}
  ],
  "servers": {
    "testimonial": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@thenavidm/testimonial-mcp-cli@latest"],
      "env": {
        "TESTIMONIAL_API_KEY": "${input:testimonial-api-token}",
        "TESTIMONIAL_TOKEN_FILE": "${input:testimonial-token-file}"
      }
    }
  }
}

Start Testimonial.to through the MCP controls, approve trust if prompted, and enter credentials in the private input prompts. Workspace .vscode/mcp.json may contain this placeholder-only structure, but never resolved secret values. Remote development runs the server in the selected remote environment, so local file paths refer to that environment.

Windsurf

Open Cascade's MCP settings or edit the private user file ~/.codeium/windsurf/mcp_config.json. Use the Claude Desktop manual mcpServers block above with your locally configured env values. See Windsurf's current MCP documentation. Restart or reconnect Testimonial.to in Cascade; Space files must not contain secrets.

Zed

Open Settings > AI > MCP Servers > Add Server > Add Local Server, or your user settings file. Zed uses context_servers:

json
{
  "context_servers": {
    "testimonial": {
      "command": "npx",
      "args": ["-y", "@thenavidm/testimonial-mcp-cli@latest"],
      "env": {
        "TESTIMONIAL_API_KEY": "YOUR_PRIVATE_API_KEY",
        "TESTIMONIAL_TOKEN_FILE": ""
      }
    }
  }
}

Enter actual values only in private user settings. Check the active-server indicator before prompting. Do not wrap command and args inside a nested command object from older Zed examples.

Gemini CLI

Merge the Claude Desktop manual mcpServers block into your private ~/.gemini/settings.json. Configure the private credential values locally, then restart Gemini CLI and inspect /mcp. See Gemini CLI's MCP configuration. Its Space settings must not contain real credentials. You can instead use the CLI from an agent shell.

Other local stdio clients use the same command and arguments, adapted to their config format. A client that only accepts a remote MCP URL cannot connect directly: this package does not ship a public HTTP listener. ChatGPT's remote connector setup is not a substitute for local stdio installation.

Docker

Build locally from the reviewed source; no prebuilt registry image is claimed:

bash
git clone https://github.com/thenavidm/testimonial-mcp-cli.git
cd testimonial-mcp-cli
docker build -t testimonial-mcp-cli .
docker run --rm -i -e TESTIMONIAL_API_KEY testimonial-mcp-cli

Cline and other local MCP clients

Use the client's Add MCP server flow with command npx, arguments -y and @thenavidm/testimonial-mcp-cli@latest, stdio transport, and private local TESTIMONIAL_API_KEY or TESTIMONIAL_TOKEN_FILE settings. UI names depend on the installed client. Reconnect and discover tools before an account call. Browser-only clients need a remote HTTPS connector; use Testimonial.to's official server rather than this local stdio command.

Verify

bash
testimonial-cli --version
testimonial-cli tools
testimonial-cli list-accounts --agent
testimonial-cli doctor
testimonial-cli doctor --network
testimonial-cli list-testimonials --limit 1 --agent

Only the last two commands contact the provider. Account outcomes, desktop GUI and actual Codex task/token usage are separate evidence. Never send email/import public proof during install verification.

Updates and removal

Restart npx@latest registrations to resolve the current version; it does not hot-replace a running process. Global installs require npm install -g again; desktop bundles require manual newer-version installation. Remove only requested registrations/package/skill/bundle, and revoke native credentials separately. Prior emails, imported proof and exports remain.

bash
npm install -g @thenavidm/testimonial-mcp-cli@latest
testimonial-cli --version
# Remove only when requested
npm uninstall -g @thenavidm/testimonial-mcp-cli

Troubleshooting

Problem	What to check
No credentials/exit10	Run login; configure exactly one intended Space source in this runtime
401/403	Actual Space key and current plan/permission; never fall back across profiles
No video returned	Native list only includes ready assets; check processing in the dashboard
page/spaceId rejected	Current Space-scoped list is a single array without pagination
Native status failed	Treat as operation error even with HTTP 200; no automatic repeat
Email refused	Actual four query fields and explicit local approval; GET is a write
Consent/publication refused	Local approval does not establish customer public-use permission
Batch hash mismatch	Review exact unchanged inputs/order/profile/schema again
Output exists or is too large	Choose a new private path and smaller native limit; no overwrite/resume
GUI cannot find Node/private file	Check actual runtime/absolute path/ACLs, then reconnect
429/timeout	Respect native limits and inspect possible outcomes before deliberate repeat

Development

bash
git clone https://github.com/thenavidm/testimonial-mcp-cli.git
cd testimonial-mcp-cli
npm ci
npm run typecheck
npm run build
npm test
npm run check:counts
npm run check:discovery
npm run sync:api -- --check
npm run build:mcpb

Source mode uses node /absolute/path/testimonial-mcp-cli/dist/index.js after building. Keep private keys out of the checkout/archive.

Output and scripting

bash
testimonial-cli tools --agent
testimonial-cli schema submit-text-testimonial
testimonial-cli list-testimonials --limit 5 --agent --select id,type

Both underscore and kebab tool spellings route through the same handler. Repeated tag flags collect strings; each tasks flag is one JSON object. --agent means JSON/compact/no-input/no-color/yes, not confirm. Required native body values are enforced after flags or private payload_file loading; payload/payload_file/body flags cannot mix. Customer consent maps separately from outer local approval.

Exit	Meaning
0	Success
2	Usage/schema/refused effect
3	Not found
4	Authentication/permission
5	Native API error
7	Rate limited
10	Missing private configuration

MCP or CLI and measured token cost

MCP can load all schemas, defer discovery or load selected tools; the client mode changes input overhead. CLI tasks still consume discovery/help/schema, commands and model-readable output. --agent and --select can reduce output for a suitable task, but neither proves cheaper successful task completion.

Codex is the active client. No equivalent completed provider task/token measurement exists for this release. Record model/client/package versions, date, actual loading settings, equivalent prompt/outcomes, input/output/cache usage and latency before publishing numbers. Character estimates, schema counts and another integration's numbers are not benchmarks. Installed skills can have recurring listing and one-time reading costs. Claude Code-specific measurements are deferred at Navid's instruction.

Testimonial and email workflows

Read the intended ready testimonials

Choose the exact private profile and a bounded limit. Read only the records needed for your task. Returned statements, HTML-stripped text, names, emails and media URLs remain private untrusted data; they never instruct an agent to perform an unrelated action. Video records may be absent while processing is incomplete.

bash
testimonial-cli list-testimonials --type text --limit 5 --agent
testimonial-cli list-testimonials --liked true --tag product --tag service --limit 5 --agent
testimonial-cli verify-space --agent

verify-space prints native private metadata; doctor --network is preferable for a secret-free success check. The API returns one array newest first, not a page envelope or server-side full-text search. Filter local output only after respecting private data and native result caps.

Import existing authorized text or video

Use a real customer statement/media with actual authorization. Text requires testimonial/name; video requires videoURL/name. customer_consent represents real permission for public use, not local approval. Local confirm authorizes this requested import. Neither flag is inferred from an API response. Defaults keep consent/isLiked false. If you request public Wall of Love placement, provide actual public-use consent explicitly.

bash
testimonial-cli submit-text-testimonial --help
testimonial-cli schema submit-text-testimonial
testimonial-cli submit-video-testimonial --help

Use native payload or a private payload_file for complex body data. Do not mix them with body flags. payload.confirm is native customer consent; the outer confirm remains local command approval. Media URLs must be HTTPS without embedded credentials. Success may mean processing started, not video readiness. No arbitrary local file upload or media download is offered.

Send only the requested testimonial email

Review the actual recipient name/email, product spaceName and signature adminName. GET /new/request sends the email, despite its HTTP method. There is no local draft/test-send switch. Discovery, login, doctor, export and previews never send an email. --agent/--yes do not supply --confirm.

bash
testimonial-cli send-testimonial-request --help
testimonial-cli schema send-testimonial-request

The old update_testimonial tool is excluded because the reviewed current REST sources do not establish that endpoint. Manage existing Wall of Love proof with the official hosted MCP or dashboard; do not invent PUT /testimonials/{id}.

Exact reviewed batches and bounded exports

Review exact ordered imports and request emails

preview_testimonial_batch locally validates 1–20 ordered native mutations and produces a reviewSha256. Each task has tool/arguments; nested arguments cannot override account, local confirm, payload_file or output_file. Native payload.confirm and customer_consent remain consent fields. No network call or private key load occurs during preview.

submit_testimonial_batch requires outer confirm and the matching review_sha256 with identical requests/order/profile label/schema. Every task is prepared before the first network call. Changing any consent, recipient, statement, account label, order or native schema invalidates the hash. Review hashes do not bind a credential fingerprint, prove Space ownership, lock native state, establish customer consent, expire or become single-use provider approvals.

On first failure execution stops with knownResults, failedIndex and unattemptedIndices. HTTP 200 status failed is an error, not a successful imported record. Failed effects may have unknown outcomes; no retry, rollback or automatic continuation occurs. Do not promise emailed delivery or processed video based on native request acceptance.

bash
testimonial-cli preview-testimonial-batch --help
testimonial-cli schema preview-testimonial-batch
testimonial-cli submit-testimonial-batch --help

Save a bounded private export

export_testimonials performs one GET /testimonials with default limit 100, local maximum 10,000 and 5 MiB response/file cap. It saves {testimonials,receipt} to an absolute new exclusive mode 0600 file in an existing private directory. Existing files/symlinks are never overwritten. On failure only its newly created partial file is removed. Windows ACLs must be restricted separately.

The receipt includes requests/items/requestedLimit/atNativeLimit/completeBackup:false/paginationSupported:false/atomicSnapshot:false plus the local byte count/hash. At the native limit, additional matching records may exist. Even fewer records do not prove a complete archive because processing, changing state and native filters affect visibility. No cursor/page/offset, continuation, media retrieval, native backup, CSV conversion or public upload is implied. Treat saved customer data privately.

bash
testimonial-cli export-testimonials --help
testimonial-cli schema export-testimonials

Every tool and argument

list_testimonials

Read one native JSON array. Only ready video assets are included; no page, cursor or offset parameters.

type

Type: string
Required: Optional
Meaning and constraints: Exact schema value. {"enum": ["text", "video"]}

liked

Type: boolean
Required: Optional
Meaning and constraints: Native Wall of Love filter.

highlighted

Type: boolean
Required: Optional
Meaning and constraints: Native highlighted filter.

tag

Type: array
Required: Optional
Meaning and constraints: Repeated native tag display names; native OR match. {"maxItems": 100}

limit

Type: integer
Required: Optional
Meaning and constraints: Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination. {"minimum": 1, "maximum": 10000}

account

Type: string
Required: Optional
Meaning and constraints: Exact configured private account profile label; not a tenant or provider account ID.

Argument	Type	Required	Meaning and constraints
`type`	string	Optional	Exact schema value. {"enum": ["text", "video"]}
`liked`	boolean	Optional	Native Wall of Love filter.
`highlighted`	boolean	Optional	Native highlighted filter.
`tag`	array	Optional	Repeated native tag display names; native OR match. {"maxItems": 100}
`limit`	integer	Optional	Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination. {"minimum": 1, "maximum": 10000}
`account`	string	Optional	Exact configured private account profile label; not a tenant or provider account ID.

bash
testimonial-cli list-testimonials --help
testimonial-cli schema list-testimonials

json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "text",
        "video"
      ]
    },
    "liked": {
      "type": "boolean",
      "description": "Native Wall of Love filter."
    },
    "highlighted": {
      "type": "boolean",
      "description": "Native highlighted filter."
    },
    "tag": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "string",
        "minLength": 1,
        "description": ""
      },
      "description": "Repeated native tag display names; native OR match."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "description": "Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination."
    },
    "account": {
      "type": "string",
      "description": "Exact configured private account profile label; not a tenant or provider account ID."
    }
  },
  "required": [],
  "additionalProperties": false
}

Native request: GET /testimonials. No native JSON body.

json
{
  "name": "list_testimonials",
  "method": "GET",
  "path": "/testimonials",
  "title": "List ready Space testimonials",
  "description": "Read one native JSON array. Only ready video assets are included; no page, cursor or offset parameters.",
  "group": "testimonials",
  "risk": "read",
  "params": [
    {
      "name": "type",
      "key": "type",
      "schema": {
        "type": "string",
        "enum": [
          "text",
          "video"
        ]
      },
      "in": "query",
      "required": false,
      "style": "form",
      "explode": true
    },
    {
      "name": "liked",
      "key": "liked",
      "schema": {
        "type": "boolean",
        "description": "Native Wall of Love filter."
      },
      "in": "query",
      "required": false,
      "style": "form",
      "explode": true
    },
    {
      "name": "highlighted",
      "key": "highlighted",
      "schema": {
        "type": "boolean",
        "description": "Native highlighted filter."
      },
      "in": "query",
      "required": false,
      "style": "form",
      "explode": true
    },
    {
      "name": "tag",
      "key": "tag",
      "schema": {
        "type": "array",
        "maxItems": 100,
        "items": {
          "type": "string",
          "minLength": 1,
          "description": ""
        },
        "description": "Repeated native tag display names; native OR match."
      },
      "in": "query",
      "required": false,
      "style": "form",
      "explode": true
    },
    {
      "name": "limit",
      "key": "limit",
      "schema": {
        "type": "integer",
        "minimum": 1,
        "maximum": 10000,
        "description": "Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination."
      },
      "in": "query",
      "required": false,
      "style": "form",
      "explode": true
    }
  ],
  "bodySchema": null,
  "bodyRequired": false,
  "privateOutput": false,
  "source": "https://help.testimonial.to/en/articles/6223143-api-get-all-testimonials"
}

verify_space

Explicit native key verification. Response includes Space id and account email; private metadata, not ownership or all-action proof.

account

Type: string
Required: Optional
Meaning and constraints: Exact configured private account profile label; not a tenant or provider account ID.

Argument	Type	Required	Meaning and constraints
`account`	string	Optional	Exact configured private account profile label; not a tenant or provider account ID.

bash
testimonial-cli verify-space --help
testimonial-cli schema verify-space

json
{
  "type": "object",
  "properties": {
    "account": {
      "type": "string",
      "description": "Exact configured private account profile label; not a tenant or provider account ID."
    }
  },
  "required": [],
  "additionalProperties": false
}

Native request: GET /verify. No native JSON body.

json
{
  "name": "verify_space",
  "method": "GET",
  "path": "/verify",
  "title": "Verify the selected Space key",
  "description": "Explicit native key verification. Response includes Space id and account email; private metadata, not ownership or all-action proof.",
  "group": "space",
  "risk": "read",
  "params": [],
  "bodySchema": null,
  "bodyRequired": false,
  "privateOutput": false,
  "source": "https://help.testimonial.to/en/articles/6223143-api-get-all-testimonials"
}

submit_text_testimonial

Import a real authorized customer statement. Local confirm approves the API call; customer_consent or payload.confirm represents actual public-use permission.

name

Type: string
Required: Optional
Meaning and constraints: Actual submitter name.

email

Type: string
Required: Optional
Meaning and constraints: {"format": "email"}

title

Type: string
Required: Optional
Meaning and constraints: Native combined title/company.

socialLink

Type: string
Required: Optional
Meaning and constraints: Native social profile value.

customer_consent

Type: boolean
Required: Optional
Meaning and constraints: Native customer permission for public use, false by default. Independent from local command approval.

isLiked

Type: boolean
Required: Optional
Meaning and constraints: Add to Wall of Love, false by default; local public-use consent is required if true.

testimonial

Type: string
Required: Optional
Meaning and constraints: Actual authorized statement.

rating

Type: integer
Required: Optional
Meaning and constraints: Exact schema value. {"minimum": 1, "maximum": 5}

avatarURL

Type: string
Required: Optional
Meaning and constraints: {"format": "uri"}

attachedImageURL

Type: string
Required: Optional
Meaning and constraints: {"format": "uri"}

account

Type: string
Required: Optional
Meaning and constraints: Exact configured private account profile label; not a tenant or provider account ID.

confirm

Type: boolean
Required: Optional
Meaning and constraints: Must be true for the requested mutation or exclusive private output file.

payload

Type: object
Required: Optional
Meaning and constraints: Complete native testimonial JSON object; do not mix with body flags or payload_file.

payload.name

Type: string
Required: Required
Meaning and constraints: Actual submitter name.

payload.email

Type: string
Required: Optional
Meaning and constraints: {"format": "email"}

payload.title

Type: string
Required: Optional
Meaning and constraints: Native combined title/company.

payload.socialLink

Type: string
Required: Optional
Meaning and constraints: Native social profile value.

payload.confirm

Type: boolean
Required: Optional
Meaning and constraints: Native customer permission for public use, false by default. Independent from local command approval.

payload.isLiked

Type: boolean
Required: Optional
Meaning and constraints: Add to Wall of Love, false by default; local public-use consent is required if true.

payload.testimonial

Type: string
Required: Required
Meaning and constraints: Actual authorized statement.

payload.rating

Type: integer
Required: Optional
Meaning and constraints: Exact schema value. {"minimum": 1, "maximum": 5}

payload.avatarURL

Type: string
Required: Optional
Meaning and constraints: {"format": "uri"}

payload.attachedImageURL

Type: string
Required: Optional
Meaning and constraints: {"format": "uri"}

payload_file

Type: string
Required: Optional
Meaning and constraints: Absolute regular non-symlink JSON body file, at most 1 MiB. Cannot mix with payload/body flags.

Argument	Type	Required	Meaning and constraints
`name`	string	Optional	Actual submitter name.
`email`	string	Optional	{"format": "email"}
`title`	string	Optional	Native combined title/company.
`socialLink`	string	Optional	Native social profile value.
`customer_consent`	boolean	Optional	Native customer permission for public use, false by default. Independent from local command approval.
`isLiked`	boolean	Optional	Add to Wall of Love, false by default; local public-use consent is required if true.
`testimonial`	string	Optional	Actual authorized statement.
`rating`	integer	Optional	Exact schema value. {"minimum": 1, "maximum": 5}
`avatarURL`	string	Optional	{"format": "uri"}
`attachedImageURL`	string	Optional	{"format": "uri"}
`account`	string	Optional	Exact configured private account profile label; not a tenant or provider account ID.
`confirm`	boolean	Optional	Must be true for the requested mutation or exclusive private output file.
`payload`	object	Optional	Complete native testimonial JSON object; do not mix with body flags or payload_file.
`payload.name`	string	Required	Actual submitter name.
`payload.email`	string	Optional	{"format": "email"}
`payload.title`	string	Optional	Native combined title/company.
`payload.socialLink`	string	Optional	Native social profile value.
`payload.confirm`	boolean	Optional	Native customer permission for public use, false by default. Independent from local command approval.
`payload.isLiked`	boolean	Optional	Add to Wall of Love, false by default; local public-use consent is required if true.
`payload.testimonial`	string	Required	Actual authorized statement.
`payload.rating`	integer	Optional	Exact schema value. {"minimum": 1, "maximum": 5}
`payload.avatarURL`	string	Optional	{"format": "uri"}
`payload.attachedImageURL`	string	Optional	{"format": "uri"}
`payload_file`	string	Optional	Absolute regular non-symlink JSON body file, at most 1 MiB. Cannot mix with payload/body flags.

bash
testimonial-cli submit-text-testimonial --help
testimonial-cli schema submit-text-testimonial

json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Actual submitter name."
    },
    "email": {
      "type": "string",
      "minLength": 1,
      "description": "",
      "format": "email"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Native combined title/company."
    },
    "socialLink": {
      "type": "string",
      "minLength": 1,
      "description": "Native social profile value."
    },
    "customer_consent": {
      "type": "boolean",
      "description": "Native customer permission for public use, false by default. Independent from local command approval."
    },
    "isLiked": {
      "type": "boolean",
      "description": "Add to Wall of Love, false by default; local public-use consent is required if true."
    },
    "testimonial": {
      "type": "string",
      "minLength": 1,
      "description": "Actual authorized statement."
    },
    "rating": {
      "type": "integer",
      "minimum": 1,
      "maximum": 5
    },
    "avatarURL": {
      "type": "string",
      "minLength": 1,
      "description": "",
      "format": "uri"
    },
    "attachedImageURL": {
      "type": "string",
      "minLength": 1,
      "description": "",
      "format": "uri"
    },
    "account": {
      "type": "string",
      "description": "Exact configured private account profile label; not a tenant or provider account ID."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true for the requested mutation or exclusive private output file."
    },
    "payload": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "description": "Actual submitter name."
        },
        "email": {
          "type": "string",
          "minLength": 1,
          "description": "",
          "format": "email"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "description": "Native combined title/company."
        },
        "socialLink": {
          "type": "string",
          "minLength": 1,
          "description": "Native social profile value."
        },
        "confirm": {
          "type": "boolean",
          "description": "Native customer permission for public use, false by default. Independent from local command approval."
        },
        "isLiked": {
          "type": "boolean",
          "description": "Add to Wall of Love, false by default; local public-use consent is required if true."
        },
        "testimonial": {
          "type": "string",
          "minLength": 1,
          "description": "Actual authorized statement."
        },
        "rating": {
          "type": "integer",
          "minimum": 1,
          "maximum": 5
        },
        "avatarURL": {
          "type": "string",
          "minLength": 1,
          "description": "",
          "format": "uri"
        },
        "attachedImageURL": {
          "type": "string",
          "minLength": 1,
          "description": "",
          "format": "uri"
        }
      },
      "required": [
        "testimonial",
        "name"
      ],
      "additionalProperties": false,
      "description": "Complete native testimonial JSON object; do not mix with body flags or payload_file."
    },
    "payload_file": {
      "type": "string",
      "minLength": 1,
      "description": "Absolute regular non-symlink JSON body file, at most 1 MiB. Cannot mix with payload/body flags."
    }
  },
  "required": [],
  "additionalProperties": false
}

Native request: POST /submit/text. Native body requires testimonial, name. Top-level confirm is local approval; body/payload.confirm is native consent.

json
{
  "name": "submit_text_testimonial",
  "method": "POST",
  "path": "/submit/text",
  "title": "Submit an authorized text testimonial",
  "description": "Import a real authorized customer statement. Local confirm approves the API call; customer_consent or payload.confirm represents actual public-use permission.",
  "group": "testimonials",
  "risk": "destructive",
  "params": [],
  "bodySchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "description": "Actual submitter name."
      },
      "email": {
        "type": "string",
        "minLength": 1,
        "description": "",
        "format": "email"
      },
      "title": {
        "type": "string",
        "minLength": 1,
        "description": "Native combined title/company."
      },
      "socialLink": {
        "type": "string",
        "minLength": 1,
        "description": "Native social profile value."
      },
      "confirm": {
        "type": "boolean",
        "description": "Native customer permission for public use, false by default. Independent from local command approval."
      },
      "isLiked": {
        "type": "boolean",
        "description": "Add to Wall of Love, false by default; local public-use consent is required if true."
      },
      "testimonial": {
        "type": "string",
        "minLength": 1,
        "description": "Actual authorized statement."
      },
      "rating": {
        "type": "integer",
        "minimum": 1,
        "maximum": 5
      },
      "avatarURL": {
        "type": "string",
        "minLength": 1,
        "description": "",
        "format": "uri"
      },
      "attachedImageURL": {
        "type": "string",
        "minLength": 1,
        "description": "",
        "format": "uri"
      }
    },
    "required": [
      "testimonial",
      "name"
    ],
    "additionalProperties": false
  },
  "bodyRequired": true,
  "privateOutput": false,
  "source": "https://help.testimonial.to/en/articles/6451677-api-submit-a-text-testimonial"
}

submit_video_testimonial

Import a real publicly accessible authorized video. Provider retrieves/processes the URL; this package never downloads it. Success does not mean processing finished.

name

Type: string
Required: Optional
Meaning and constraints: Actual submitter name.

email

Type: string
Required: Optional
Meaning and constraints: {"format": "email"}

title

Type: string
Required: Optional
Meaning and constraints: Native combined title/company.

socialLink

Type: string
Required: Optional
Meaning and constraints: Native social profile value.

customer_consent

Type: boolean
Required: Optional
Meaning and constraints: Native customer permission for public use, false by default. Independent from local command approval.

isLiked

Type: boolean
Required: Optional
Meaning and constraints: Add to Wall of Love, false by default; local public-use consent is required if true.

videoURL

Type: string
Required: Optional
Meaning and constraints: Existing public HTTPS video URL without credentials. {"format": "uri"}

account

Type: string
Required: Optional
Meaning and constraints: Exact configured private account profile label; not a tenant or provider account ID.

confirm

Type: boolean
Required: Optional
Meaning and constraints: Must be true for the requested mutation or exclusive private output file.

payload

Type: object
Required: Optional
Meaning and constraints: Complete native testimonial JSON object; do not mix with body flags or payload_file.

payload.name

Type: string
Required: Required
Meaning and constraints: Actual submitter name.

payload.email

Type: string
Required: Optional
Meaning and constraints: {"format": "email"}

payload.title

Type: string
Required: Optional
Meaning and constraints: Native combined title/company.

payload.socialLink

Type: string
Required: Optional
Meaning and constraints: Native social profile value.

payload.confirm

Type: boolean
Required: Optional
Meaning and constraints: Native customer permission for public use, false by default. Independent from local command approval.

payload.isLiked

Type: boolean
Required: Optional
Meaning and constraints: Add to Wall of Love, false by default; local public-use consent is required if true.

payload.videoURL

Type: string
Required: Required
Meaning and constraints: Existing public HTTPS video URL without credentials. {"format": "uri"}

payload_file

Type: string
Required: Optional
Meaning and constraints: Absolute regular non-symlink JSON body file, at most 1 MiB. Cannot mix with payload/body flags.

Argument	Type	Required	Meaning and constraints
`name`	string	Optional	Actual submitter name.
`email`	string	Optional	{"format": "email"}
`title`	string	Optional	Native combined title/company.
`socialLink`	string	Optional	Native social profile value.
`customer_consent`	boolean	Optional	Native customer permission for public use, false by default. Independent from local command approval.
`isLiked`	boolean	Optional	Add to Wall of Love, false by default; local public-use consent is required if true.
`videoURL`	string	Optional	Existing public HTTPS video URL without credentials. {"format": "uri"}
`account`	string	Optional	Exact configured private account profile label; not a tenant or provider account ID.
`confirm`	boolean	Optional	Must be true for the requested mutation or exclusive private output file.
`payload`	object	Optional	Complete native testimonial JSON object; do not mix with body flags or payload_file.
`payload.name`	string	Required	Actual submitter name.
`payload.email`	string	Optional	{"format": "email"}
`payload.title`	string	Optional	Native combined title/company.
`payload.socialLink`	string	Optional	Native social profile value.
`payload.confirm`	boolean	Optional	Native customer permission for public use, false by default. Independent from local command approval.
`payload.isLiked`	boolean	Optional	Add to Wall of Love, false by default; local public-use consent is required if true.
`payload.videoURL`	string	Required	Existing public HTTPS video URL without credentials. {"format": "uri"}
`payload_file`	string	Optional	Absolute regular non-symlink JSON body file, at most 1 MiB. Cannot mix with payload/body flags.

bash
testimonial-cli submit-video-testimonial --help
testimonial-cli schema submit-video-testimonial

json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Actual submitter name."
    },
    "email": {
      "type": "string",
      "minLength": 1,
      "description": "",
      "format": "email"
    },
    "title": {
      "type": "string",
      "minLength": 1,
      "description": "Native combined title/company."
    },
    "socialLink": {
      "type": "string",
      "minLength": 1,
      "description": "Native social profile value."
    },
    "customer_consent": {
      "type": "boolean",
      "description": "Native customer permission for public use, false by default. Independent from local command approval."
    },
    "isLiked": {
      "type": "boolean",
      "description": "Add to Wall of Love, false by default; local public-use consent is required if true."
    },
    "videoURL": {
      "type": "string",
      "minLength": 1,
      "description": "Existing public HTTPS video URL without credentials.",
      "format": "uri"
    },
    "account": {
      "type": "string",
      "description": "Exact configured private account profile label; not a tenant or provider account ID."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true for the requested mutation or exclusive private output file."
    },
    "payload": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string",
          "minLength": 1,
          "description": "Actual submitter name."
        },
        "email": {
          "type": "string",
          "minLength": 1,
          "description": "",
          "format": "email"
        },
        "title": {
          "type": "string",
          "minLength": 1,
          "description": "Native combined title/company."
        },
        "socialLink": {
          "type": "string",
          "minLength": 1,
          "description": "Native social profile value."
        },
        "confirm": {
          "type": "boolean",
          "description": "Native customer permission for public use, false by default. Independent from local command approval."
        },
        "isLiked": {
          "type": "boolean",
          "description": "Add to Wall of Love, false by default; local public-use consent is required if true."
        },
        "videoURL": {
          "type": "string",
          "minLength": 1,
          "description": "Existing public HTTPS video URL without credentials.",
          "format": "uri"
        }
      },
      "required": [
        "videoURL",
        "name"
      ],
      "additionalProperties": false,
      "description": "Complete native testimonial JSON object; do not mix with body flags or payload_file."
    },
    "payload_file": {
      "type": "string",
      "minLength": 1,
      "description": "Absolute regular non-symlink JSON body file, at most 1 MiB. Cannot mix with payload/body flags."
    }
  },
  "required": [],
  "additionalProperties": false
}

Native request: POST /submit/video. Native body requires videoURL, name. Top-level confirm is local approval; body/payload.confirm is native consent.

json
{
  "name": "submit_video_testimonial",
  "method": "POST",
  "path": "/submit/video",
  "title": "Submit an authorized video testimonial",
  "description": "Import a real publicly accessible authorized video. Provider retrieves/processes the URL; this package never downloads it. Success does not mean processing finished.",
  "group": "testimonials",
  "risk": "destructive",
  "params": [],
  "bodySchema": {
    "type": "object",
    "properties": {
      "name": {
        "type": "string",
        "minLength": 1,
        "description": "Actual submitter name."
      },
      "email": {
        "type": "string",
        "minLength": 1,
        "description": "",
        "format": "email"
      },
      "title": {
        "type": "string",
        "minLength": 1,
        "description": "Native combined title/company."
      },
      "socialLink": {
        "type": "string",
        "minLength": 1,
        "description": "Native social profile value."
      },
      "confirm": {
        "type": "boolean",
        "description": "Native customer permission for public use, false by default. Independent from local command approval."
      },
      "isLiked": {
        "type": "boolean",
        "description": "Add to Wall of Love, false by default; local public-use consent is required if true."
      },
      "videoURL": {
        "type": "string",
        "minLength": 1,
        "description": "Existing public HTTPS video URL without credentials.",
        "format": "uri"
      }
    },
    "required": [
      "videoURL",
      "name"
    ],
    "additionalProperties": false
  },
  "bodyRequired": true,
  "privateOutput": false,
  "source": "https://help.testimonial.to/en/articles/6236786-api-submit-a-video-testimonial"
}

send_testimonial_request

Side-effecting GET sends a real request email. Explicit local confirmation is mandatory. No dry run, retry or delivery guarantee.

name

Type: string
Required: Required
Meaning and constraints: Actual approved email context.

email

Type: string
Required: Required
Meaning and constraints: Actual approved email context. {"format": "email"}

spaceName

Type: string
Required: Required
Meaning and constraints: Actual approved email context.

adminName

Type: string
Required: Required
Meaning and constraints: Actual approved email context.

account

Type: string
Required: Optional
Meaning and constraints: Exact configured private account profile label; not a tenant or provider account ID.

confirm

Type: boolean
Required: Optional
Meaning and constraints: Must be true for the requested mutation or exclusive private output file.

Argument	Type	Required	Meaning and constraints
`name`	string	Required	Actual approved email context.
`email`	string	Required	Actual approved email context. {"format": "email"}
`spaceName`	string	Required	Actual approved email context.
`adminName`	string	Required	Actual approved email context.
`account`	string	Optional	Exact configured private account profile label; not a tenant or provider account ID.
`confirm`	boolean	Optional	Must be true for the requested mutation or exclusive private output file.

bash
testimonial-cli send-testimonial-request --help
testimonial-cli schema send-testimonial-request

json
{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "minLength": 1,
      "description": "Actual approved email context."
    },
    "email": {
      "type": "string",
      "minLength": 1,
      "description": "Actual approved email context.",
      "format": "email"
    },
    "spaceName": {
      "type": "string",
      "minLength": 1,
      "description": "Actual approved email context."
    },
    "adminName": {
      "type": "string",
      "minLength": 1,
      "description": "Actual approved email context."
    },
    "account": {
      "type": "string",
      "description": "Exact configured private account profile label; not a tenant or provider account ID."
    },
    "confirm": {
      "type": "boolean",
      "description": "Must be true for the requested mutation or exclusive private output file."
    }
  },
  "required": [
    "name",
    "email",
    "spaceName",
    "adminName"
  ],
  "additionalProperties": false
}

Native request: GET /new/request. No native JSON body. Side-effecting GET email still needs approval.

json
{
  "name": "send_testimonial_request",
  "method": "GET",
  "path": "/new/request",
  "title": "Send a requested testimonial email",
  "description": "Side-effecting GET sends a real request email. Explicit local confirmation is mandatory. No dry run, retry or delivery guarantee.",
  "group": "testimonials",
  "risk": "destructive",
  "params": [
    {
      "name": "name",
      "key": "name",
      "schema": {
        "type": "string",
        "minLength": 1,
        "description": "Actual approved email context."
      },
      "in": "query",
      "required": true,
      "style": "form",
      "explode": true
    },
    {
      "name": "email",
      "key": "email",
      "schema": {
        "type": "string",
        "minLength": 1,
        "description": "Actual approved email context.",
        "format": "email"
      },
      "in": "query",
      "required": true,
      "style": "form",
      "explode": true
    },
    {
      "name": "spaceName",
      "key": "spaceName",
      "schema": {
        "type": "string",
        "minLength": 1,
        "description": "Actual approved email context."
      },
      "in": "query",
      "required": true,
      "style": "form",
      "explode": true
    },
    {
      "name": "adminName",
      "key": "adminName",
      "schema": {
        "type": "string",
        "minLength": 1,
        "description": "Actual approved email context."
      },
      "in": "query",
      "required": true,
      "style": "form",
      "explode": true
    }
  ],
  "bodySchema": null,
  "bodyRequired": false,
  "privateOutput": false,
  "source": "https://help.testimonial.to/en/articles/6223146-api-send-request"
}

list_accounts

Local profile labels/default/auth method only. No keys, token paths, provider identity or network request.

Argument	Type	Required	Meaning and constraints

bash
testimonial-cli list-accounts --help
testimonial-cli schema list-accounts

json
{
  "type": "object",
  "properties": {},
  "required": [],
  "additionalProperties": false
}

get_operation_schema

Local reviewed method/path/query/body schema and provenance for one native tool. No credentials or provider request.

operation

Type: string
Required: Required
Meaning and constraints: Exact native tool name, e.g. submit_text_testimonial or send_testimonial_request. {"enum": ["list_testimonials", "verify_space", "submit_text_testimonial", "submit_video_testimonial", "send_testimonial_request"]}

Argument	Type	Required	Meaning and constraints
`operation`	string	Required	Exact native tool name, e.g. submit_text_testimonial or send_testimonial_request. {"enum": ["list_testimonials", "verify_space", "submit_text_testimonial", "submit_video_testimonial", "send_testimonial_request"]}

bash
testimonial-cli get-operation-schema --help
testimonial-cli schema get-operation-schema

json
{
  "type": "object",
  "properties": {
    "operation": {
      "type": "string",
      "enum": [
        "list_testimonials",
        "verify_space",
        "submit_text_testimonial",
        "submit_video_testimonial",
        "send_testimonial_request"
      ],
      "description": "Exact native tool name, e.g. submit_text_testimonial or send_testimonial_request."
    }
  },
  "required": [
    "operation"
  ],
  "additionalProperties": false
}

preview_testimonial_batch

Local validation and SHA-256 of exact ordered text/video import/email work, selected profile label and reviewed schema. No provider reads, key load, identity check, price or rollback guarantee.

tasks

Type: array
Required: Required
Meaning and constraints: One to twenty exact ordered supported text/video import/email operations. Each task is one exact native import or one email request. Customer consent is separate from local approval. {"minItems": 1, "maxItems": 20}

tasks[].tool

Type: string
Required: Required
Meaning and constraints: Exact schema value. {"enum": ["submit_text_testimonial", "submit_video_testimonial", "send_testimonial_request"]}

tasks[].arguments

Type: object
Required: Required
Meaning and constraints: Actual native tool arguments without account, confirm, payload_file or output_file.

account

Type: string
Required: Optional
Meaning and constraints: Exact selected private account profile; binds label, not key ownership.

Argument	Type	Required	Meaning and constraints
`tasks`	array	Required	One to twenty exact ordered supported text/video import/email operations. Each task is one exact native import or one email request. Customer consent is separate from local approval. {"minItems": 1, "maxItems": 20}
`tasks[].tool`	string	Required	Exact schema value. {"enum": ["submit_text_testimonial", "submit_video_testimonial", "send_testimonial_request"]}
`tasks[].arguments`	object	Required	Actual native tool arguments without account, confirm, payload_file or output_file.
`account`	string	Optional	Exact selected private account profile; binds label, not key ownership.

bash
testimonial-cli preview-testimonial-batch --help
testimonial-cli schema preview-testimonial-batch

json
{
  "type": "object",
  "properties": {
    "tasks": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "description": "One to twenty exact ordered supported text/video import/email operations. Each task is one exact native import or one email request. Customer consent is separate from local approval.",
      "items": {
        "type": "object",
        "properties": {
          "tool": {
            "type": "string",
            "enum": [
              "submit_text_testimonial",
              "submit_video_testimonial",
              "send_testimonial_request"
            ]
          },
          "arguments": {
            "type": "object",
            "description": "Actual native tool arguments without account, confirm, payload_file or output_file."
          }
        },
        "required": [
          "tool",
          "arguments"
        ],
        "additionalProperties": false
      }
    },
    "account": {
      "type": "string",
      "description": "Exact selected private account profile; binds label, not key ownership."
    }
  },
  "required": [
    "tasks"
  ],
  "additionalProperties": false
}

submit_testimonial_batch

Confirmed one-to-twenty ordered text/video import/email tasks. Prevalidate all and verify exact hash before first request. Stop on first failure with known results/failed index/unattempted indices; no retries, rollback or implicit continuation.

tasks

Type: array
Required: Required
Meaning and constraints: One to twenty exact ordered supported text/video import/email operations. Each task is one exact native import or one email request. Customer consent is separate from local approval. {"minItems": 1, "maxItems": 20}

tasks[].tool

Type: string
Required: Required
Meaning and constraints: Exact schema value. {"enum": ["submit_text_testimonial", "submit_video_testimonial", "send_testimonial_request"]}

tasks[].arguments

Type: object
Required: Required
Meaning and constraints: Actual native tool arguments without account, confirm, payload_file or output_file.

account

Type: string
Required: Optional
Meaning and constraints: Exact selected private account profile; binds label, not key ownership.

confirm

Type: boolean
Required: Optional
Meaning and constraints: Explicit approval for this exact requested ordered batch.

review_sha256

Type: string
Required: Required
Meaning and constraints: Exact preview_testimonial_batch hash for identical requests, profile label, schema and order. {"pattern": "^[a-f0-9]{64}$"}

Argument	Type	Required	Meaning and constraints
`tasks`	array	Required	One to twenty exact ordered supported text/video import/email operations. Each task is one exact native import or one email request. Customer consent is separate from local approval. {"minItems": 1, "maxItems": 20}
`tasks[].tool`	string	Required	Exact schema value. {"enum": ["submit_text_testimonial", "submit_video_testimonial", "send_testimonial_request"]}
`tasks[].arguments`	object	Required	Actual native tool arguments without account, confirm, payload_file or output_file.
`account`	string	Optional	Exact selected private account profile; binds label, not key ownership.
`confirm`	boolean	Optional	Explicit approval for this exact requested ordered batch.
`review_sha256`	string	Required	Exact preview_testimonial_batch hash for identical requests, profile label, schema and order. {"pattern": "^[a-f0-9]{64}$"}

bash
testimonial-cli submit-testimonial-batch --help
testimonial-cli schema submit-testimonial-batch

json
{
  "type": "object",
  "properties": {
    "tasks": {
      "type": "array",
      "minItems": 1,
      "maxItems": 20,
      "description": "One to twenty exact ordered supported text/video import/email operations. Each task is one exact native import or one email request. Customer consent is separate from local approval.",
      "items": {
        "type": "object",
        "properties": {
          "tool": {
            "type": "string",
            "enum": [
              "submit_text_testimonial",
              "submit_video_testimonial",
              "send_testimonial_request"
            ]
          },
          "arguments": {
            "type": "object",
            "description": "Actual native tool arguments without account, confirm, payload_file or output_file."
          }
        },
        "required": [
          "tool",
          "arguments"
        ],
        "additionalProperties": false
      }
    },
    "account": {
      "type": "string",
      "description": "Exact selected private account profile; binds label, not key ownership."
    },
    "confirm": {
      "type": "boolean",
      "description": "Explicit approval for this exact requested ordered batch."
    },
    "review_sha256": {
      "type": "string",
      "pattern": "^[a-f0-9]{64}$",
      "description": "Exact preview_testimonial_batch hash for identical requests, profile label, schema and order."
    }
  },
  "required": [
    "tasks",
    "review_sha256"
  ],
  "additionalProperties": false
}

export_testimonials

Confirmed single native GET saved to a new exclusive mode 0600 JSON file, default limit 100/local maximum 10,000 and 5 MiB response/file cap. No pagination, continuation, media download, overwrite or atomic complete-backup claim.

type

Type: string
Required: Optional
Meaning and constraints: Exact schema value. {"enum": ["text", "video"]}

liked

Type: boolean
Required: Optional
Meaning and constraints: Native Wall of Love filter.

highlighted

Type: boolean
Required: Optional
Meaning and constraints: Native highlighted filter.

tag

Type: array
Required: Optional
Meaning and constraints: Repeated native tag display names; native OR match. {"maxItems": 100}

limit

Type: integer
Required: Optional
Meaning and constraints: Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination. {"minimum": 1, "maximum": 10000}

account

Type: string
Required: Optional
Meaning and constraints: Exact configured private account profile label; not a tenant or provider account ID.

confirm

Type: boolean
Required: Optional
Meaning and constraints: Explicit approval to save this bounded response to a new private file.

output_file

Type: string
Required: Required
Meaning and constraints: Absolute new file in an existing private directory; restrict Windows ACLs separately.

Argument	Type	Required	Meaning and constraints
`type`	string	Optional	Exact schema value. {"enum": ["text", "video"]}
`liked`	boolean	Optional	Native Wall of Love filter.
`highlighted`	boolean	Optional	Native highlighted filter.
`tag`	array	Optional	Repeated native tag display names; native OR match. {"maxItems": 100}
`limit`	integer	Optional	Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination. {"minimum": 1, "maximum": 10000}
`account`	string	Optional	Exact configured private account profile label; not a tenant or provider account ID.
`confirm`	boolean	Optional	Explicit approval to save this bounded response to a new private file.
`output_file`	string	Required	Absolute new file in an existing private directory; restrict Windows ACLs separately.

bash
testimonial-cli export-testimonials --help
testimonial-cli schema export-testimonials

json
{
  "type": "object",
  "properties": {
    "type": {
      "type": "string",
      "enum": [
        "text",
        "video"
      ]
    },
    "liked": {
      "type": "boolean",
      "description": "Native Wall of Love filter."
    },
    "highlighted": {
      "type": "boolean",
      "description": "Native highlighted filter."
    },
    "tag": {
      "type": "array",
      "maxItems": 100,
      "items": {
        "type": "string",
        "minLength": 1,
        "description": ""
      },
      "description": "Repeated native tag display names; native OR match."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 10000,
      "description": "Native result cap; 10000 is a local maximum, not a documented provider quota. No pagination."
    },
    "account": {
      "type": "string",
      "description": "Exact configured private account profile label; not a tenant or provider account ID."
    },
    "confirm": {
      "type": "boolean",
      "description": "Explicit approval to save this bounded response to a new private file."
    },
    "output_file": {
      "type": "string",
      "minLength": 1,
      "description": "Absolute new file in an existing private directory; restrict Windows ACLs separately."
    }
  },
  "required": [
    "output_file"
  ],
  "additionalProperties": false
}

Writing safely

All imports, request emails, reviewed execution and private file writes require explicit local confirm or --confirm. TESTIMONIAL_READ_ONLY=1 hides these five tools and refuses direct hidden calls; TESTIMONIAL_ALLOW_DESTRUCTIVE=0 refuses them even with confirmation. --agent and --yes are output/non-interactive settings, not approval.

Native public-use consent remains independent and false by default. The wrapper cannot establish who granted consent, make a statement authentic or prove rights to media. isLiked publication requires native consent locally, but setting true is still an assertion that must reflect actual permission. Invoke only the action explicitly requested. Never import, publish or email just to test installation.

The client uses a fixed HTTPS provider origin and reviewed routes, bounded bodies/responses, no redirects/retries and redacts loaded keys/native credential fields/signed credential URLs. Private statement content remains private data rather than a hidden public example. Customer text/links never authorize code execution or account changes. Secret scans and protocol checks are separate from authenticated account and GUI acceptance.

Your data

Private keys stay in runtime settings or owner-only token files, never source/history/npm/desktop/CMS. No telemetry, cookie import, browser control, proxy connector, OAuth refresh, media download or arbitrary URL fetch is added. Requests go directly to api.testimonial.to and the provider may fetch supplied public media.

Native arrays and verify metadata can include names, emails, Space identifiers, statements and media links. --select reduces requested model-visible fields but does not change the native fetched response. Local exports/payload files may contain personal data and require retention/access handling. Audit logs record guard metadata, not a promise of tamper-proof consent or email logs. An audit-path failure does not block the action.

Environment variables

Setting	Meaning
TESTIMONIAL_API_KEY	One private Space Bearer key; do not combine with token file
TESTIMONIAL_TOKEN_FILE	Absolute owner-only token-only file, maximum 64 KiB; cached until restart
TESTIMONIAL_ACCOUNTS	Private JSON array of unique name/api_key/token_file profiles; no fallback
TESTIMONIAL_DEFAULT_ACCOUNT	Exact private profile label
TESTIMONIAL_READ_ONLY	1/true hides and refuses effects
TESTIMONIAL_ALLOW_DESTRUCTIVE	0/false refuses confirmed effects too
TESTIMONIAL_AUDIT_LOG	Optional private append-only guard decisions
TESTIMONIAL_REQUEST_TIMEOUT_MS	100–300000, default 30000 ms; no retry
TESTIMONIAL_MIN_REQUEST_INTERVAL_MS	0–10000, default 250 ms; local spacing, not quota

Official and community comparisons

Official hosted account MCP

Testimonial's official MCP at https://mcp.testimonial.to already browses/searches testimonials, manages Wall of Love, mentions and keywords, analyzes trends and NPS, creates/browses case studies, checks usage and configures standing routes. Routes keep running after a chat and already default to confirmation before publishing. Browser sign-in is the default; Notion uses a header token, and Advanced tokens are a fallback for clients without browser authorization.

Use the official connector for that wider native experience. REST Space keys and hosted access tokens are different integration paths. Current provider material specifies REST Ultimate/Ultimate+ per Space; reviewed hosted help snapshots differ in explicit plan wording, so verify eligibility in AI & Agents and Settings > Plan instead of treating the absence of an upgrade label as unrestricted access. This package neither creates standing routes nor exposes undocumented analytics/NPS/keyword endpoints.

Real terminal alternatives

A dedicated provider task CLI was not identified in the reviewed sources on October 3, 2026. That does not mean the official MCP cannot be used from a terminal. wong2/mcp-cli, pinned at 7d12b4648b1c3e2a7341113407002c1b0f700d1b, supports remote Streamable HTTP/SSE, OAuth and non-interactive tool calls. The official MCP Inspector also supports CLI calls. They can call the broad official connector using its native authorization and approved tools.

Searches for Testimonial-specific public MCP/task-CLI repositories did not identify an independent source suitable to pin; this is a search finding, not evidence none exist. The private old five-tool repo is separately reviewed, not misrepresented as an independent community implementation.

Why offer this companion

This owned implementation supplies a focused shared task CLI/local MCP, isolated Space credentials, separate local approval/customer consent, direct read-only refusal even for a side-effecting GET, exact locally reviewed imports/emails and a bounded exclusive private export. These behaviors are exercised through the actual handlers and CLI; provider outcomes, actual desktop GUI and matched Codex costs remain separate evidence.

No universal superiority, more-total-provider-coverage or measured token saving is claimed. The official MCP remains broader. This REST companion cannot update existing Wall of Love items, manage mentions/keywords, create case studies or run standing automation through undocumented endpoints.

Task interface

This package: 10 shared CLI/local MCP tasks
Existing alternatives: Official hosted MCP plus generic terminal clients

Native scope

This package: 5 reviewed REST operations
Existing alternatives: Hosted tools cover additional product areas

Consent

This package: Local confirm separated from actual customer public-use permission
Existing alternatives: Official provider/client controls remain native

Profiles

This package: Private named Space keys with no fallback
Existing alternatives: Hosted browser authorization or native token connection

Reviewed work

This package: Exact ordered imports/emails, prevalidation and stop on failure
Existing alternatives: No provider-state lock or replacement for customer permission

Exports

This package: One bounded array to a new private file
Existing alternatives: No pagination, atomic backup or media download

Token costs

This package: Actual matched Codex task measurement pending
Existing alternatives: No blanket MCP-versus-CLI percentage

Capability	This package	Existing alternatives
Task interface	10 shared CLI/local MCP tasks	Official hosted MCP plus generic terminal clients
Native scope	5 reviewed REST operations	Hosted tools cover additional product areas
Consent	Local confirm separated from actual customer public-use permission	Official provider/client controls remain native
Profiles	Private named Space keys with no fallback	Hosted browser authorization or native token connection
Reviewed work	Exact ordered imports/emails, prevalidation and stop on failure	No provider-state lock or replacement for customer permission
Exports	One bounded array to a new private file	No pagination, atomic backup or media download
Token costs	Actual matched Codex task measurement pending	No blanket MCP-versus-CLI percentage

Versions and migration

Legacy tool	Current 2.0.1 contract
list_testimonials	Same name, selected Space key, native single-array filters; no spaceId/page/per_page
submit_text_testimonial	Same name, POST/submit/text with testimonial/name and separate consent
submit_video_testimonial	Same name, POST/submit/video with videoURL/name and separate consent
update_testimonial	Excluded: current reviewed REST contract not established; use hosted MCP/dashboard
send_testimonial_request	Same name, confirmed GET/new/request with four required fields

Private five-tool 1.0.0 history stays intact and out of public refs. Version 2.0.1 is a major native argument/route correction, not a claim every legacy capability remains valid. AGPL-3.0 is preserved.

Component	Reviewed version
Package/desktop	2.0.1
Native REST	v1, five operations checked 2026-10-03
Generic MCP CLI	7d12b4648b1c3e2a7341113407002c1b0f700d1b
Node	>=22
Behavior/bridge checks	54 passing tests
Actual Codex task/token use	Pending

CHANGELOG.md records dated changes.

Locked dependency versions

@modelcontextprotocol/sdk

Exact lock version: 1.32.0
Role: Runtime

ajv

Exact lock version: 8.20.0
Role: Runtime

ajv-formats

Exact lock version: 3.0.1
Role: Runtime

@anthropic-ai/mcpb

Exact lock version: 2.1.2
Role: Development/packaging

@types/node

Exact lock version: 22.20.5
Role: Development/packaging

typescript

Exact lock version: 7.0.2
Role: Development/packaging

vite

Exact lock version: 8.3.2
Role: Development/packaging

vitest

Exact lock version: 5.0.3
Role: Development/packaging

Dependency	Exact lock version	Role
@modelcontextprotocol/sdk	1.32.0	Runtime
ajv	8.20.0	Runtime
ajv-formats	3.0.1	Runtime
@anthropic-ai/mcpb	2.1.2	Development/packaging
@types/node	22.20.5	Development/packaging
typescript	7.0.2	Development/packaging
vite	8.3.2	Development/packaging
vitest	5.0.3	Development/packaging

These versions are from this release’s package-lock.json. Runtime dependencies ship in npm and the desktop bundle; packaging tools do not enter the desktop runtime.

Complete command examples

The following commands contain fictional example data and are documentation only. Replace them with the exact requested recipient or authorized customer material and intended Space profile. Running a confirmed command performs a real import or sends an email. Omitted customer consent keeps the imported proof private; only assert customer_consent when actual public-use permission exists.

bash
testimonial-cli submit-text-testimonial --name "Example customer" --testimonial "An authorized customer statement" --confirm --agent
testimonial-cli submit-video-testimonial --name "Example customer" --videoURL "https://example.com/authorized-video.mp4" --confirm --agent

Email request example (four native required fields):

bash
testimonial-cli send-testimonial-request --name "Example customer" --email "customer@example.com" --spaceName "Example product" --adminName "Example sender" --confirm --agent

A local preview makes no provider request. Record its reviewSha256, inspect the exact work, then use the same task JSON/profile with submit-testimonial-batch --review-sha256 "SHA256_FROM_YOUR_PREVIEW" --confirm only when that work is requested:

bash
testimonial-cli preview-testimonial-batch --tasks '{"tool":"submit_text_testimonial","arguments":{"name":"Example customer","testimonial":"An authorized customer statement"}}' --agent

Version 2.0.0 introduced the current REST companion; 2.0.1 corrects export approval and payload help. Native routes, approval behavior and ten-tool coverage are unchanged.

More tools for customer proof

Connect the services your customer and publishing tasks need.

Senja MCP server & CLI Kit MCP server & CLI Circle MCP server & CLI

Testimonial.to MCP Server & CLI FAQs

Official MCP comparison, Space access, separate consent and approval, native emails, bounded exports and maintenance.

Does Testimonial.to already have an official MCP?

Yes.

Its hosted connector already covers broader testimonials, Wall of Love, mentions/keywords, analytics, NPS, case studies and standing routes.

Browser authorization is the default, with native token fallbacks.

This package is a focused REST task companion, not a replacement for all official tools.

Why offer a CLI alongside the official MCP?

The useful addition is a shared task CLI/local MCP with isolated Space keys, separate local approval/customer consent, explicit read-only refusal, exact reviewed ordered imports/emails and private bounded JSON exports.

Generic MCP CLIs already call the hosted connector; no universal absence or superiority is claimed.

Which plan and key do I need?

Current REST docs specify Ultimate/Ultimate+ per Space.

Copy the intended Space key from its dashboard card menu.

Hosted MCP plan wording varies in reviewed snapshots; verify current eligibility in the account.

This wrapper grants no bypass and does not use a browser session as a Space key.

Where should credentials live?

Use one private TESTIMONIAL_API_KEY or absolute owner-only TESTIMONIAL_TOKEN_FILE outside repositories, at most 64 KiB.

Windows ACLs need separate restriction.

Never publish resolved values, token URLs, keys or customer data in source, bundles, CMS or screenshots.

Can I use several Spaces?

Yes, with private named TESTIMONIAL_ACCOUNTS profiles.

A unique label selects one Space key/file, with no global or cross-Space fallback.

A label is not native ownership proof. list_accounts does not make network calls or expose token paths.

Does login or doctor authenticate automatically?

Explicit doctor --network requests GET /verify and prints success metadata without native email/id.

It does not create keys, sign in, import cookies, verify every endpoint or send email.

Which native operations are included?

GET testimonials, GET verify, POST submit/text, POST submit/video and side-effecting GET new/request.

The five helpers are list_accounts, get_operation_schema, preview_testimonial_batch, submit_testimonial_batch and export_testimonials.

Can this update existing Wall of Love items or manage mentions?

No reviewed REST contract for the legacy update endpoint was established.

Use the official MCP/dashboard for existing Wall of Love, mentions, keywords, analytics, case studies and routes.

No undocumented route or fake supported tool is exposed.

What is the difference between confirm and customer_consent?

Outer confirm or --confirm is local approval for this requested operation. customer_consent or native payload.confirm represents actual customer permission for public use, default false.

They never imply each other.

Do not manufacture consent to satisfy a command.

Does isLiked publish a testimonial?

Native isLiked adds imported proof to the Wall of Love, default false.

This package refuses isLiked true without explicit actual public-use consent.

It cannot establish authenticity, rights or who granted permission; native published placement remains an effect.

Why is the email GET treated as a write?

GET /new/request sends a real email using name, email, spaceName and adminName.

It requires explicit local approval, is hidden/refused in read-only and is not called during discovery, setup, previews or export.

There is no automatic test email or delivery guarantee.

Does video submission mean processing is complete?

No.

The provider retrieves the public HTTPS video and can process it after acceptance.

Native list only returns ready video assets.

The package never downloads the video or treats success as completion or consent proof.

How do list filters and tags work?

The current endpoint returns one newest-first array for the selected Space key. type, liked, highlighted, repeated tag display names and limit are native filters; tags use OR matching. page, offset, cursor and spaceId are refused.

No native full-text search is invented.

Is an export a complete backup?

No.

One bounded native response is saved to a new private JSON file, default limit 100, local maximum 10,000 and 5 MiB cap.

Receipt completeBackup and atomicSnapshot remain false.

Filtering, processing and changing native state limit visibility; there is no pagination, resume or media download.

Can exports overwrite files?

No.

Exclusive creation refuses existing paths/symlinks before any request.

Failure removes only the new partial file.

POSIX files use 0600; restrict Windows ACLs separately.

Returned metadata never echoes the private customer array.

What does a reviewed batch guarantee?

Every 1–20 exact ordered operation is validated before the first request; hash binds requests/order/profile label/schema.

It is not a key fingerprint, provider-state lock, customer permission record, expiry or single-use approval token.

Preview makes no network call or key load.

What happens if a batch fails?

Stop immediately with knownResults, failedIndex and unattemptedIndices; HTTP 200 status failed is an error.

Unknown native outcomes may remain.

No retry, rollback or automatic continuation occurs; inspect native state before deliberately repeating.

Can an agent bypass read-only or use agent mode as approval?

No.

READ_ONLY hides and directly refuses all five effect/file tools.

ALLOW_DESTRUCTIVE=0 refuses confirmed effects too.

Agent/yes formatting never supplies local confirm or customer consent.

Which clients and operating systems work?

Node 22+ local stdio clients and the CLI work on macOS, Windows and Linux; INSTALL documents Codex first, Claude Code/Desktop, Cursor, VS Code/Copilot, Windsurf, Zed, Gemini CLI, Docker and other stdio clients.

Browser-only clients need a supported remote connector, such as the official MCP.

Protocol/CI evidence is not actual GUI installation.

How are updates and token comparisons handled?

Restart npx@latest registrations, update global CLI installs explicitly and install newer desktop bundles manually.

Actual equivalent Codex task/token measurement remains pending.

Loading modes, schemas/help, output, skills and caching affect cost; no borrowed percentage, character estimate or universal superiority is claimed.

Navid Moazzez

AI business strategist & AI OS builder

Navid Moazzez helps creators and founders master AI and build their own AI Operating System (AI OS) to automate their business and life.

Navid.me is reader-supported. When you buy through links on this site, I may earn an affiliate commission. Learn more.

More MCP servers & CLIs

View all

Senja MCP server & CLI

Find proof, review exact changes and export bounded private testimonials.

Sales

Senja

Kit MCP server & CLI

Draft newsletters, manage subscribers and tags, inspect email stats and automate Kit API v4.

Newsletters

Kit

Circle MCP server & CLI

Read members and spaces, draft posts and perform requested Circle Admin API v2 actions.

Communities

Circle

Bluesky MCP server & CLI

Post, read and search Bluesky from Claude, Codex or Cursor, or from your terminal.

Social media

Bluesky

Substack MCP server & CLI

Draft posts, publish Notes and check your stats on Substack from Claude, Codex or Cursor.

Newsletters

Substack

Threads MCP server & CLI

Post, reply and read your insights on Threads from Claude, Codex or Cursor.

Social media

Threads

Mastodon MCP server & CLI

Post, edit and read your timelines on any Mastodon instance from Claude, Codex or Cursor.

Social media

Mastodon

TikTok MCP server & CLI

Rank your videos, read your stats and publish to TikTok from Claude, Codex or Cursor.

Social media

TikTok

ThriveCart MCP server & CLI

Check revenue, customers, subscriptions and affiliates in ThriveCart from Claude, Codex or Cursor.

Sales

ThriveCart

WordPress MCP server & CLI

Edit posts, pages, Elementor and Rank Math SEO on WordPress from Claude, Codex or Cursor.

Blogs

WordPress

Midjourney MCP server & CLI

Generate images, follow jobs and download the files from Midjourney with Claude, Codex or Cursor.

AI images

Midjourney

Google Photos MCP server & CLI

Pick photos, build albums and upload to Google Photos from Claude, Codex or Cursor.

Photos

Google Photos

Apple Photos MCP server & CLI

Search, look at and organize your Apple Photos library from Claude, Codex or Cursor, on your Mac.

Photos

Apple Photos

Apple Podcasts MCP server & CLI

Track chart ranks, read reviews and search your podcast library from Claude, Codex or Cursor.

Podcasts

Apple Podcasts

Podcast Index MCP server & CLI

Search 4 million podcasts and read episode transcripts from Claude, Codex or Cursor.

Podcasts

Podcast Index

Google Search Console MCP server & CLI

Read your search traffic, check indexing and submit sitemaps from Claude, Codex or Cursor.

SEO

Google Search Console

Google Workspace MCP server & CLI

Work across Gmail, Drive, Sheets, Docs and Calendar from Claude, Codex or Cursor.

Productivity

Google Workspace

iMessage MCP server & CLI

Catch up, search your history and send iMessages from Claude, Codex or Cursor, on your Mac.

Messaging

iMessage

Facebook Ad Library MCP server & CLI

Research the ads any brand runs on Facebook and Instagram, from Claude, Codex or Cursor.

Research

Facebook

Vimeo MCP server & CLI

Read transcripts, file videos into folders and add chapters from Claude, Codex or Cursor.

Video

Vimeo

YouTube MCP server & CLI

Read any video's transcript, research channels and manage your own from Claude, Codex or Cursor.

Video

YouTube

Telegram MCP server & CLI

Catch up, search years of chats and reply on Telegram from Claude, Codex or Cursor.

Messaging

Adobe Firefly MCP server & CLI

Generate and edit images, make videos and composite products through Adobe Firefly Services.

AI images

Adobe Firefly

OP3 MCP server & CLI

Read your podcast's downloads, real listeners and retention from Claude, Codex or Cursor.

Podcasts

OP3

Beehiiv MCP server & CLI

Draft newsletters, inspect subscriber lists and analytics, and automate Beehiiv API v2.

Newsletters

Beehiiv

Calendly MCP server & CLI

Find slots, book approved meetings and work with Calendly contacts and meeting recaps.

Sales

Calendly

Wistia MCP server & CLI

Work with videos, captions, uploads, analytics and approved Wistia account actions.

Video

Wistia

ScrapeCreators MCP server & CLI

Research public profiles, transcripts, comments and ads with explicit paid-call approval.

Social media

ScrapeCreators

Shotstack MCP server & CLI

Render, manage templates and inspect media with private profiles and confirmed operations.

Video

Shotstack

Gumloop MCP server & CLI

Inspect flows and agents, run approved automation and handle files privately.

Productivity

Gumloop

Buffer MCP server & CLI

Inspect publishing data, review drafts and execute only approved mutations.

Social media

Buffer

Cloudflare MCP server & CLI

Inspect DNS and review exact requests before approving zone changes.

Productivity

Cloudflare

Bannerbear MCP server & CLI

Inspect templates, review exact render batches and run approved media workflows.

AI images

Bannerbear

Brandfetch MCP server & CLI

Retrieve brand data, compare identities and save approved private assets.

Research

Brandfetch

Creatomate MCP server & CLI

Inspect templates, validate designs and submit exact approved render batches.

Video

Creatomate

Dub MCP server & CLI

Manage requested short links and partner work with private profiles and exact approval.

Sales

Dub

fal.ai MCP server & CLI

Discover models, review exact approved generation and manage requested Assets.

Video

fal.ai

Flodesk MCP server & CLI

Manage requested subscribers, drafts, workflows, custom fields and webhooks.

Sales

Flodesk

Fluent WordPress MCP server & CLI

Read CRM, Community and Forms; apply approved native tasks and save private snapshots.

Sales

WordPress

Related free tools

All free tools

X character counter

Counts the way X counts: links as 23, emoji as 2. LinkedIn, Instagram, TikTok, Threads and YouTube limits too.

Writing

Bluesky

LinkedIn character counter

LinkedIn's 3,000-character post limit, counted as you type, with X, Threads and Bluesky beside it.

Writing

Threads character counter

Threads' 500-character limit, counted as you type, with X, Bluesky and LinkedIn beside it.

Writing

Threads

Bluesky character counter

Bluesky's 300-character limit, counted the way the protocol counts, with X and Threads beside it.

Writing

Bluesky

Mastodon character counter

Mastodon's 500-character default, counted the way Mastodon counts links and mentions.

Writing

Mastodon

Instagram character counter

Instagram's 2,200-character caption limit, counted as you type, with TikTok and the rest beside it.

Writing

Instagram

TikTok character counter

TikTok's 2,200 caption limit, counted the way TikTok counts it, with emoji as 2.

Writing

TikTok

Pinterest character counter

Pin titles (100) and descriptions (800), counted as you type.

Writing

YouTube character counter

YouTube titles (100) and descriptions (5,000), counted as you type.

Writing

YouTube

llms.txt generator

Build your llms.txt from your live site, check every link and your AI crawler access, and add llms-full.txt.

AIAny website

UTM builder

Clean UTM links, the GA4 channel each one lands in, presets for creators, and many links at once.

Links and QRAny website

Schema markup generator

Schema markup (JSON-LD) for the types Google shows today, checked against Google's own rules, plus a check for any page.

SEOAny website

Testimonial.to MCP Server & CLI

Add it with a single command in a terminal.

In Claude Code, type /mcp. Testimonial.to should show as connected.

Key takeaways

What is the Testimonial.to MCP server & CLI?

Testimonials and emails

Space verification

Private local workflows

Install and connect

Requirements

CLI

Private Space setup

Select the intended Space

Separate profiles and revocation

Native effects and local limits

Codex

Claude Code

Claude Desktop

Install the .mcpb extension

Manual config

Cursor

VS Code and Copilot

Windsurf

Zed

Gemini CLI

Docker

Cline and other local MCP clients

Verify

Updates and removal

Troubleshooting

Development

Output and scripting

MCP or CLI and measured token cost

Testimonial and email workflows

Read the intended ready testimonials

Import existing authorized text or video

Send only the requested testimonial email

Exact reviewed batches and bounded exports

Review exact ordered imports and request emails

Save a bounded private export

Every tool and argument

list_testimonials

verify_space

submit_text_testimonial

submit_video_testimonial

send_testimonial_request

list_accounts

get_operation_schema

preview_testimonial_batch

submit_testimonial_batch

export_testimonials

Writing safely

Your data

Environment variables

Official and community comparisons

Official hosted account MCP

Real terminal alternatives

Why offer this companion

Versions and migration

Locked dependency versions

Complete command examples

Testimonial.to MCP Server & CLI FAQs

More MCP servers & CLIs

Senja MCP server & CLI

Kit MCP server & CLI

Circle MCP server & CLI

Bluesky MCP server & CLI

Substack MCP server & CLI

Threads MCP server & CLI

Mastodon MCP server & CLI

TikTok MCP server & CLI

ThriveCart MCP server & CLI

WordPress MCP server & CLI

Midjourney MCP server & CLI

Google Photos MCP server & CLI

Apple Photos MCP server & CLI

Apple Podcasts MCP server & CLI

Podcast Index MCP server & CLI

Google Search Console MCP server & CLI

Google Workspace MCP server & CLI