Skip to main content
Glama

Get Account Overview

dynamoi_get_account_overview
Read-only

Start here when a musician asks to promote a new single, check how a release is doing, make a song link, get music on Spotify, or grow a YouTube channel and the artist is not yet identified. Use this when the user explicitly asks about the signed-in Dynamoi account itself, such as who is logged in, how many organizations or artists it can access, or whether account-level platform connections exist. Pass intent to match that explicit account question; it defaults to account_overview. Do not use this to confirm a specific Meta or YouTube onboarding attempt because this account-level state can span multiple artists; use dynamoi_get_platform_status for the target artist instead. Do not use this to enumerate artists one by one; use dynamoi_list_artists for that. Never use this to 'check context' before answering generic Instagram, lyrics, songwriting, or marketing-advice questions, even if Dynamoi is attached.

Input Schema

NameRequiredDescriptionDefault
formatNo
intentNoaccount_overview

Output Schema

NameRequiredDescriptionDefault
codeNo
dataNo
kindNo
fieldNo
statusYes
draftIdNo
messageNo
retryableNo
nextActionNo
failureStageNo
prerequisiteNo
screeningResultNo
retryAfterSecondsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / code / enum
      Previous value: -[
      -  "ACCOUNT_READ_ONLY",
      -  "INVALID_SPOTIFY_SOURCE",
      -  "CAPABILITY_REQUIRED",
      -  "INSUFFICIENT_SCOPE",
      -  "STATE_CONFLICT",
      -  "QUOTE_CHANGED",
      -  "RATE_LIMITED",
      -  "OUTPUT_INVALID",
      -  "UNKNOWN_EFFECT"
      -]New value: +[
      +  "ACCOUNT_READ_ONLY",
      +  "INVALID_SPOTIFY_SOURCE",
      +  "CAPABILITY_REQUIRED",
      +  "INSUFFICIENT_SCOPE",
      +  "TENANT_ACCESS_DENIED",
      +  "STATE_CONFLICT",
      +  "QUOTE_CHANGED",
      +  "RATE_LIMITED",
      +  "OUTPUT_INVALID",
      +  "UNKNOWN_EFFECT"
      +]
  2. Changed3 schema fields changed
    • addedOutput schema / properties / draftId
      Added value: +{
      +  "format": "uuid",
      +  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
      +  "type": "string"
      +}
    • addedOutput schema / properties / failureStage
      Added value: +{
      +  "maxLength": 120,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / screeningResult
      Added value: +{
      +  "maxLength": 120,
      +  "minLength": 1,
      +  "type": "string"
      +}
  3. Changed4 schema fields changed
    • removedInput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
    • addedInput schema / properties / intent / default
      Added value: +"account_overview"
    • removedInput schema / required
      Removed value: -[
      -  "intent"
      -]
    • removedOutput schema / $schema
      Removed value: -"http://json-schema.org/draft-07/schema#"
  4. Changed2 schema fields changed
    • addedInput schema / $schema
      Added value: +"http://json-schema.org/draft-07/schema#"
    • addedOutput schema / $schema
      Added value: +"http://json-schema.org/draft-07/schema#"
  5. Changed6 schema fields changed
    • addedOutput schema / properties / code
      Added value: +{
      +  "enum": [
      +    "ACCOUNT_READ_ONLY",
      +    "INVALID_SPOTIFY_SOURCE",
      +    "CAPABILITY_REQUIRED",
      +    "INSUFFICIENT_SCOPE",
      +    "STATE_CONFLICT",
      +    "QUOTE_CHANGED",
      +    "RATE_LIMITED",
      +    "OUTPUT_INVALID",
      +    "UNKNOWN_EFFECT"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / field
      Added value: +{
      +  "maxLength": 120,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / nextAction
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "field": {
      +      "maxLength": 120,
      +      "minLength": 1,
      +      "type": "string"
      +    },
      +    "kind": {
      +      "enum": [
      +        "provide_input",
      +        "read_status",
      +        "reconnect",
      +        "handoff"
      +      ],
      +      "type": "string"
      +    },
      +    "reason": {
      +      "maxLength": 240,
      +      "minLength": 1,
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "kind"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / prerequisite
      Added value: +{
      +  "maxLength": 240,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / retryAfterSeconds
      Added value: +{
      +  "maximum": 86400,
      +  "minimum": 0,
      +  "type": "integer"
      +}
    • addedOutput schema / properties / retryable
      Added value: +{
      +  "type": "boolean"
      +}
  6. Changed9 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +{}
    • addedOutput schema / properties / data / properties / artistCount
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / data / properties / artists
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "count": {
      +      "type": "number"
      +    },
      +    "summaries": {
      +      "items": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "id": {
      +            "type": "string"
      +          },
      +          "name": {
      +            "type": "string"
      +          },
      +          "publicUrl": {
      +            "type": "string"
      +          },
      +          "summary": {
      +            "type": "string"
      +          }
      +        },
      +        "type": "object"
      +      },
      +      "type": "array"
      +    }
      +  },
      +  "required": [
      +    "count",
      +    "summaries"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / data / properties / organizationCount
      Added value: +{
      +  "type": "number"
      +}
    • addedOutput schema / properties / data / properties / recommendedNextActions
      Added value: +{
      +  "items": {
      +    "type": "string"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / data / properties / state
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {},
      +  "type": "object"
      +}
    • addedOutput schema / properties / data / properties / summary
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / data / properties / user
      Added value: +{
      +  "additionalProperties": false,
      +  "properties": {
      +    "name": {
      +      "type": "string"
      +    }
      +  },
      +  "type": "object"
      +}
    • removedOutput schema / properties / kind / enum
      Removed value: -[
      -  "validation",
      -  "business",
      -  "platform",
      -  "unknown"
      -]
  7. Changed4 schema fields changed
    • changedOutput schema / additionalProperties
      Previous value: -{}New value: +false
    • addedOutput schema / properties / data
      Added value: +{
      +  "additionalProperties": {},
      +  "properties": {},
      +  "type": "object"
      +}
    • addedOutput schema / properties / kind
      Added value: +{
      +  "enum": [
      +    "validation",
      +    "business",
      +    "platform",
      +    "unknown"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / message
      Added value: +{
      +  "type": "string"
      +}
  8. Changed1 schema field changed
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": {},
      +  "properties": {
      +    "status": {
      +      "enum": [
      +        "success",
      +        "partial_success",
      +        "error"
      +      ],
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "status"
      +  ],
      +  "type": "object"
      +}
  9. First observed

TDQS

A4/5.0
Behavior4/5

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

Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so the safety profile is covered. The description adds meaningful behavioral context beyond that: account-level state can span multiple artists, which is exactly why it should not be used to confirm a single onboarding attempt. Output format is not described, but an output schema exists to carry that.

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 routing information is front-loaded and useful, but the sentence is long and enumerates a broad list of musician intents ('promote a new single, check how a release is doing, make a song link...') that overlaps with the later prohibition on generic questions. Some of this text could be trimmed without loss, and the lead-in slightly dilutes the account-scoped purpose.

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?

For a two-parameter, read-only lookup with an output schema covering return values, the description is nearly complete: it establishes purpose, routing, and the multi-artist scope caveat. The only remaining gap is the unexplained 'format' parameter, which is minor given the self-describing enum.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate, and it partially does: it explains that 'intent' should match the explicit account question and that it defaults to account_overview, adding meaning beyond the enum list. The 'format' parameter (json/summary) receives no explanation at all, leaving that choice to inference from the enum values alone.

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

Purpose4/5

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

The description names a specific resource (the signed-in Dynamoi account) and enumerates concrete scope items it covers: who is logged in, how many organizations/artists are accessible, and whether account-level platform connections exist. It clearly distinguishes itself from siblings like dynamoi_list_artists and dynamoi_get_platform_status. The opening 'start here when a musician asks...' hook is slightly broad and in mild tension with the later narrowing, but the core purpose is unambiguous.

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?

It gives explicit when-to-use (user explicitly asks about the signed-in account itself), explicit when-NOT (do not use to confirm a Meta/YouTube onboarding attempt, do not enumerate artists), and names the correct alternatives for each exclusion (dynamoi_get_platform_status, dynamoi_list_artists). It even rules out a misuse pattern ('check context' before generic questions), which is unusually thorough routing guidance.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.