Skip to main content
Glama
tokportal

tokportal-mcp

Official
by tokportal

tokportal_reveal_account_credentials

Retrieve delivered account credentials by providing a saved account ID, the current policy version, and an acknowledgment of support forfeit. Credit cost is determined by account creation date and managed policy.

Instructions

Reveal delivered account credentials. The first credential or verification-code access is priced from this saved account's created_at timestamp against the immutable managed_pricing_new_customer_cutover_at value, never from the workspace action-pricing cohort or August 14 grace deadline. A saved account created before the cutoff permanently keeps the prior API contract: the reveal costs 0 credits, requires no new versioned acknowledgment body, and is irreversible; support and ban coverage end, but the account is not detached and existing TokPortal task access remains available. A saved account created at or after the cutoff follows the managed policy and requires the explicit versioned acknowledgment handshake: normally 150 credits, or the stored $10 legacy / $15 new per-30-day rate when Account Owning is already admin-approved. Crossing the Account Owning eligibility threshold only submits an admin review request and never activates it automatically. While approval is pending, reveal remains available for 150 credits on a post-cutoff account. Under the managed policy the charge is final and non-refundable, and reveal permanently detaches the account, makes it read-only, and ends TokPortal Coverage, all task access, analytics updates, support, ban protection, replacement, refunds, compensation and credit restoration. TokPortal is not responsible for later access, performance, reach, security, restrictions or bans. The debit or Account Owning activation, reveal marker and Coverage shutdown commit atomically. Previously revealed accounts are not charged a second time. Do not send Idempotency-Key: this response contains credentials and is never stored in the replay ledger. A request that includes the header is rejected before any ledger claim, reveal, debit, or secret access with IDEMPOTENCY_KEY_NOT_ALLOWED_FOR_SENSITIVE_RESPONSE (400). After an uncertain transport result, fetch the safe account state before deciding whether to call this endpoint again without the header.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
idYesSaved account ID.
bodyNoJSON request body.
Behavior1/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description states the reveal is irreversible, permanently detaches the account, makes it read-only, and ends TokPortal coverage — clearly destructive behavior. However, annotations mark destructiveHint: false, creating a direct contradiction. Per guidelines, score 1 with annotation_contradiction flag.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is comprehensive but verbose — multiple paragraphs with dense technical details. While no sentence is truly wasted, the structure could be improved (e.g., separating policy case logic from idempotency notes). Front-loading the core purpose is good, but length reduces clarity for quick scanning.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complexity (two pricing policies, idempotency constraints, error codes) and absence of an output schema, the description covers most critical aspects: cost, prerequisites, irreversible consequences, and error handling. However, it does not describe the success response format (e.g., which fields are returned), which is a gap.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, baseline 3. The description adds significant context beyond schema: explains that policy_version is required only for post-cutoff accounts, details the cost implications, and clarifies that acknowledge_support_forfeit is only needed on first reveal. This enhances parameter understanding.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description starts with 'Reveal delivered account credentials' and thoroughly explains the action, resource, and context of credential reveal. It distinguishes itself from other tools by detailing the pricing and policy conditions tied to account creation timestamps, which no sibling tool addresses.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides explicit guidance on when to use the tool based on account creation date relative to a cutoff, including prerequisites (policy_version acknowledgement) and cost conditions. It also warns against sending Idempotency-Key and advises fetching safe account state after uncertain transport before retrying.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/tokportal/tokportal-python'

If you have feedback or need assistance with the MCP directory API, please join our Discord server