Account and brand settings
Discover your brand agents and credit balance, set brand display name and content language, and send feedback to the Pendium team.
Read your account, find the syntheticId values that every other tool needs, adjust a brand's public display name and content language, and send feedback from an agent session.
When to use
Start any session with get_account — it returns your plan, credit balance, and every brand agent (owned or shared) with its latest score, so you can pick the syntheticId the rest of the tools require. Reach for update_brand_name and set_language when tuning how a brand presents and what language its auto-generated content is written in, and send_feedback whenever a tool misbehaves or you have an idea to improve it.
Typical sequence
get_account— discover yoursyntheticIdvalues, plan, and credit balance.update_brand_name— set the public display name shown on the brand's Brand Index page.set_language— set the language used for newly auto-generated content.send_feedback— report a bug, friction point, or idea at any time.
Tools
get_account
Get your Pendium account info: credit balance, plan tier, and every brand agent you can access — owned or shared with you through a team group — each with its latest visibility score. Call this first when connecting a new agent: it shows what's available and gives you the syntheticId values every other tool needs.
Authentication: Required
Takes no parameters.
Key response fields:
| Field | Description |
|---|---|
plan | Current plan: "free", "starter", or "pro" |
creditBalance | Remaining credits. A warning appears when balance ≤ 5 (unless credits are unlimited). |
creditsUnlimited | true when the account has unlimited credits (platform admins). When true, present the balance as unlimited rather than the raw creditBalance number, and no low-credit warning is shown. |
agents | Brand agents owned by or shared with this account |
agents[].syntheticId | The agent ID used in all other tool calls |
agents[].latestScore | Most recent visibility score (0–100), or null if no scan |
update_brand_name
Set the brand's public display name — the name shown on its public Brand Index page (/brands/{brandSlug}). Changes the display name only, not the URL slug. Synchronous, no LLM call, no credit cost. The agent must already have a Brand Index entry; the call is rejected otherwise.
Authentication: Required
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | integer | Yes | The agent whose public brand name to update. |
name | string | Yes | The new public brand display name. |
Returns success, the syntheticId, the new name, and the brandSlug.
set_language
Set the agent's content language — the language new auto-generated content (queries, personas, posts, etc.) is written in. Accepts a curated name or a custom one (e.g. Spanish, Brazilian Portuguese); an empty value resets to English. Synchronous, no LLM call, no credit cost. Changing the language does not regenerate existing content — it only affects the next auto-generation.
Authentication: Required
| Parameter | Type | Required | Description |
|---|---|---|---|
syntheticId | integer | Yes | The agent whose content language to set. |
language | string | Yes | The content language (e.g. Spanish, Brazilian Portuguese). An empty value resets to English. |
Returns success, the syntheticId, and the resolved language.
send_feedback
Send feedback, bug reports, or feature suggestions to the Pendium team directly from an agent session. Use it when you hit an error, get unexpected data, run into UX friction, or have an idea for how a tool could work better. Include as much context as possible — what you were trying to do, what happened, and what you expected.
Authentication: Required. Rate limited to 10 calls/hour per user.
| Parameter | Type | Required | Description |
|---|---|---|---|
category | enum | Yes | bug (broken), friction (works but harder than it should be), feature_request, data_quality (results seem wrong/incomplete), or praise. |
summary | string (≤200) | Yes | One-line summary of the feedback. |
tool_name | string | No | Which Pendium tool this relates to, e.g. get_account. |
detail | string (≤2000) | No | Full context: what you tried, what happened, what you expected, any suggested fix. |
severity | enum | No | blocks_workflow, degrades_experience, minor, or suggestion. |
context | object | No | Structured session context: syntheticId, client (e.g. claude-code), error_message. |
Free-text fields are sanitized and screened before storage. Pendium reviews all agent feedback to improve the MCP experience.