Skip to main content
Glama

Get a coin's creator record

get_creator_record
Read-onlyIdempotent

Get a verified coin's creator record

The creator record of a verified coin: how many coins its creator launched before, how many are still trading and how many died within a week, when they first launched, how old the wallet is and who funded it, plus what the creator has done with this coin since (events) and "Bundled at open". Read from chains and kept by Chain Daddy; the answer can lag the chain by up to a day. state is pending until the record is first computed, and offPlatformPending stays true while launches on other platforms are still being read. Answers 404 for a ticker with no verified page on that chain, for a page Chain Daddy removed, and everywhere while the creator record is off. Keyless, the same for every caller, and cached for about a minute.

The token address may stand where the ticker goes: a verified coin's address answers the same record as its ticker. Any coin: the address of a coin nobody registered with Chain Daddy answers its creator record too. The answer then also names the creator (creator) and where the chain names them (creatorSource). It is pending until the creator and their launches have been read (seconds to minutes; cached for seconds, so it can be asked again), and unknown when the chain does not name a creator Chain Daddy can read. Reading a new coin's creator starts only for a request from a web browser; any other caller gets what is already known, or pending.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "chain": "<chain>",
      "symbol": "<symbol>"
    },
    "name": "get_creator_record"
  }
}

Input Schema

NameRequiredDescriptionDefault
chainYesChain key, lowercase, as in the page's own address (e.g. `base`, `solana`). A numeric chain ID answers 404.
symbolYesThe coin's ticker (letters and digits, any case), or the token address of a coin nobody registered

Output Schema

NameRequiredDescriptionDefault
stateNo`pending` (not read yet), `first_launch` (no earlier launch found), `on_record` (earlier launches found), `serial` (many launches, most dead within a week), `blocked` (refused new launches here) or, for a coin read by its address, `unknown` (the chain names no creator Chain Daddy can read).
backedNoThe coin's own Backed vault, as its Terms card states it: the creator's fee share is held and paid out only while their wallets keep what they committed. Absent when the launch has no vault.
eventsNoWhat the creator did with this coin, newest first
labelsNo
creatorNoThe creator's wallet, on a coin read by its address (absent on a registered coin)
ruleHitNoOn a `blocked` record, the category of rule that blocked the creator; `definitions.rule` is the one line shown with it
evidenceNoWhat the coin's own metadata names and whether it points back, what the coin shares with other coins, and labels from a pinned classifier. Each line's definition is in `definitions` (`links_back`, `named_on_coins`, `shared_with_coins`, `shared_template`, `shared_analytics_id`, `shared_certificate`, `age_days`). Absent until there is something to show; each part is absent when empty. Not part of the block rule.
holdingsNoWhat the creator holds of this coin. Absent until the coin is watched (it traded in the last 7 days).
identityNoWhat the creator proved about who they are. Absent when nothing is proved.
openBlockNo"Bundled at open": who bought in the coin's opening blocks (EVM: the launch block and the next 3; Solana: the first 30 slots). Absent when the opening blocks were not seen.
promotersNoWallets this coin pays a share of its creator fees to (paid promotion), each with its record from launches here. Omitted when the coin pays none. Not part of the block rule.
computedAtNoWhen the record was last computed; absent while `pending`
definitionsNoThe definition of each word the record uses, by key
funderLabelNoWho first funded the creator's wallet, when the funder is a known operator (e.g. an exchange)
supportEmailNoOn a `blocked` record, where the creator contests the block
creatorSourceNoWhere the chain names the creator, on a coin read by its address: `launchpad_record` (the launch program's own record of its creator), `fee_share` (the coin's creator-fee config), `launch_pool` (the pool the coin launched in), `mint_authority` (the mint's authority), `creation_tx` (sent the creation transaction), `factory_call` (called the contract that created it) or `payout_recipient` (the coin's payout recipient).
exemptWalletsNoHow many wallets this coin's launch transaction exempted from the venue's opening-trade tax, read from the launch's own input. Absent when the venue has no such list; 0 when the list was empty. Those wallets are shown, not counted as the creator's.
firstLaunchAtNo
launchesAliveNoOf those, how many still trade (a trade in the last 7 days)
launchesTotalNoCoins this creator launched, here and on other platforms
walletAgeDaysNo
fundedTogetherNoThe transaction that paid the creator's wallet together with many other wallets before this launch (an airdrop batch, for one). Absent when there was none, or when the wallet that signed it is a service (an exchange, a bridge, a bot) or one of Chain Daddy's own.
launchesDead7dNoOf those, how many stopped trading within 7 days of launch
backedForfeitedNoHow many of the creator's other launches forfeited their Backed vault. Absent when none.
launchesUnknownNoOf those, how many are neither still trading nor known to have stopped (no trade on record and no word on whether they left their launch curve). Stopped is launchesTotal − launchesAlive − launchesUnknown.
offPlatformPendingNoLaunches on other platforms are still being read; counts may grow
sameNameLaunches24hNoCoins with this name or ticker launched on this chain within a day of this one that name the same X account or website, or come from linked wallets (this one included). Shown, not counted as the creator's launches. Absent when there is no other.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / definitions / description
      Previous value: -"The one-line definition of each word the record uses, by key"New value: +"The definition of each word the record uses, by key"
  2. Changed4 schema fields changed
    • changedOutput schema / properties / exemptWallets / description
      Previous value: -"How many wallets this coin's launch transaction exempted from the venue's opening-trade tax,\nread from the launch's own input. Absent when the venue has no such list;\n0 when the list was empty. Those wallets are shown, never counted as the creator's.\n"New value: +"How many wallets this coin's launch transaction exempted from the venue's opening-trade tax,\nread from the launch's own input. Absent when the venue has no such list;\n0 when the list was empty. Those wallets are shown, not counted as the creator's.\n"
    • changedOutput schema / properties / fundedTogether / properties / funder / description
      Previous value: -"The wallet that signed it (never the contract it called)"New value: +"The wallet that signed it (not the contract it called)"
    • changedOutput schema / properties / labels / items / properties / category / description
      Previous value: -"On `flagged` only, the category a person at Chain Daddy set after reviewing reports. Neither the reviewer's notes nor any reporter is published."New value: +"On `flagged` only, the category Chain Daddy set after reviewing reports."
    • changedOutput schema / properties / sameNameLaunches24h / description
      Previous value: -"Coins with this name or ticker launched on this chain within a day of this one that name the same\nX account or website, or come from linked wallets (this one included). Shown, never counted as the\ncreator's launches. Absent when there is no other.\n"New value: +"Coins with this name or ticker launched on this chain within a day of this one that name the same\nX account or website, or come from linked wallets (this one included). Shown, not counted as the\ncreator's launches. Absent when there is no other.\n"
  3. Changed1 schema field changed
    • changedOutput schema / properties / sameNameLaunches24h / description
      Previous value: -"Coins with this coin's name or ticker launched on this chain within 24 hours of it that the record\nties to it; this coin included. Absent when there is no other.\n"New value: +"Coins with this name or ticker launched on this chain within a day of this one that name the same\nX account or website, or come from linked wallets (this one included). Shown, never counted as the\ncreator's launches. Absent when there is no other.\n"
  4. Changed6 schema fields changed
    • addedOutput schema / properties / computedAt
      Added value: +{
      +  "description": "When the record was last computed; absent while `pending`",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / evidence / description
      Previous value: -"What the coin's own metadata names and whether it points back, what the coin shares with other\ncoins, and labels from a pinned classifier. Each line's definition is in `definitions`\n(`links_back`, `named_on_coins`, `shared_with_coins`). Absent until there is something to show;\neach part is absent when empty. Not part of the block rule.\n"New value: +"What the coin's own metadata names and whether it points back, what the coin shares with other\ncoins, and labels from a pinned classifier. Each line's definition is in `definitions`\n(`links_back`, `named_on_coins`, `shared_with_coins`, `shared_template`, `shared_analytics_id`,\n`shared_certificate`, `age_days`). Absent until there is something to show;\neach part is absent when empty. Not part of the block rule.\n"
    • addedOutput schema / properties / exemptWallets
      Added value: +{
      +  "description": "How many wallets this coin's launch transaction exempted from the venue's opening-trade tax,\nread from the launch's own input. Absent when the venue has no such list;\n0 when the list was empty. Those wallets are shown, never counted as the creator's.\n",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / fundedTogether
      Added value: +{
      +  "description": "The transaction that paid the creator's wallet together with many other wallets before this launch\n(an airdrop batch, for one). Absent when there was none, or when the wallet that signed it is a\nservice (an exchange, a bridge, a bot) or one of Chain Daddy's own.\n",
      +  "properties": {
      +    "at": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "funder": {
      +      "description": "The wallet that signed it (never the contract it called)",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "minutesBeforeLaunch": {
      +      "description": "How long before the launch it was mined, in whole minutes",
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "otherWallets": {
      +      "description": "How many wallets it paid besides the creator and the funder",
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "paidExemptOrFirstBuyers": {
      +      "description": "It also paid wallets among this coin's exempt wallets or first buyers",
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "tx": {
      +      "description": "The transaction's hash",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "upstreamFunder": {
      +      "description": "The wallet that last paid the funder before it signed",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / labels / items / properties / key / description
      Previous value: -"`new_identity`, `flagged`, `creator_sold`, `creator_exited`, …"New value: +"`new_identity`, `flagged`, `creator_sold`, `creator_exited`, `exempt_wallets`, `funded_together`, `same_name_launches`, …"
    • addedOutput schema / properties / sameNameLaunches24h
      Added value: +{
      +  "description": "Coins with this coin's name or ticker launched on this chain within 24 hours of it that the record\nties to it; this coin included. Absent when there is no other.\n",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
  5. Changed2 schema fields changed
    • changedOutput schema / properties / evidence / properties / namedOnCoins / description
      Previous value: -"The sites and accounts in identityLinks that coins launched in the last 7 days also name"New value: +"The sites and accounts in identityLinks that other coins' metadata also names, as read in the last 7 days"
    • changedOutput schema / properties / evidence / properties / namedOnCoins / items / properties / coins / description
      Previous value: -"How many of those coins name it"New value: +"How many coins name it, this one included"
  6. Changed3 schema fields changed
    • addedOutput schema / properties / evidence
      Added value: +{
      +  "description": "What the coin's own metadata names and whether it points back, what the coin shares with other\ncoins, and labels from a pinned classifier. Each line's definition is in `definitions`\n(`links_back`, `named_on_coins`, `shared_with_coins`). Absent until there is something to show;\neach part is absent when empty. Not part of the block rule.\n",
      +  "properties": {
      +    "classifierLabels": {
      +      "description": "Labels from a pinned classifier, each answering one typed question",
      +      "items": {
      +        "properties": {
      +          "kind": {
      +            "description": "What the label says",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "probability": {
      +            "description": "How sure the classifier is, from 0 to 1",
      +            "type": [
      +              "number",
      +              "null"
      +            ]
      +          },
      +          "questionId": {
      +            "description": "The typed question it answers",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "version": {
      +            "description": "The pinned classifier version that answered",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "identityLinks": {
      +      "description": "The sites and accounts the coin's metadata names",
      +      "items": {
      +        "properties": {
      +          "ageDays": {
      +            "description": "How old the account, channel or site is, in days, where known",
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "kind": {
      +            "description": "`site`, or the account's platform (`x`, `telegram`, `discord`, …)",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "linksBack": {
      +            "description": "Points back at the coin or its creator (`true`), was read and does not (`false`), or not read yet (`null`)",
      +            "type": [
      +              "boolean",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "description": "The site's host, or the account (`@name` on X and Telegram)",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "namedOnCoins": {
      +      "description": "The sites and accounts in identityLinks that coins launched in the last 7 days also name",
      +      "items": {
      +        "properties": {
      +          "coins": {
      +            "description": "How many of those coins name it",
      +            "type": [
      +              "integer",
      +              "null"
      +            ]
      +          },
      +          "kind": {
      +            "description": "As in identityLinks",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "name": {
      +            "description": "As in identityLinks",
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          }
      +        },
      +        "type": [
      +          "object",
      +          "null"
      +        ]
      +      },
      +      "type": [
      +        "array",
      +        "null"
      +      ]
      +    },
      +    "sharedWith": {
      +      "description": "How many other coins have the same thing as this coin; a thing no other coin shares is absent",
      +      "properties": {
      +        "analyticsId": {
      +          "description": "The same analytics or pixel id on their sites",
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "certificate": {
      +          "description": "The same TLS certificate on their sites",
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "image": {
      +          "description": "The same image, by perceptual hash",
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "pinningAccount": {
      +          "description": "The same pinning or gateway account behind their metadata",
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        },
      +        "template": {
      +          "description": "The same website template",
      +          "type": [
      +            "integer",
      +            "null"
      +          ]
      +        }
      +      },
      +      "type": [
      +        "object",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / labels / items / properties / category
      Added value: +{
      +  "description": "On `flagged` only, the category a person at Chain Daddy set after reviewing reports. Neither the reviewer's notes nor any reporter is published.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / labels / items / properties / key / description
      Previous value: -"`new_identity`, …"New value: +"`new_identity`, `flagged`, `creator_sold`, `creator_exited`, …"
  7. Changed6 schema fields changed
    • addedOutput schema / properties / backed
      Added value: +{
      +  "description": "The coin's own Backed vault, as its Terms card states it: the creator's fee share is held and paid\nout only while their wallets keep what they committed. Absent when the launch has no vault.\n",
      +  "properties": {
      +    "cliffEnd": {
      +      "description": "Nothing is paid before this (unix seconds)",
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "committed": {
      +      "description": "The wallets' holding is on record in the vault",
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "committedCoins": {
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "committedPctSupply": {
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "forfeited": {
      +      "description": "The hold broke and the creator's fees go to holders for good",
      +      "type": [
      +        "boolean",
      +        "null"
      +      ]
      +    },
      +    "heldPct": {
      +      "description": "The wallets' own balance as a share of what they committed, as last read",
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "holdUntil": {
      +      "description": "The obligation ends here (unix seconds); absent means no end",
      +      "type": [
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "minHoldPct": {
      +      "description": "Share of the committed holding the wallets must keep",
      +      "type": [
      +        "number",
      +        "null"
      +      ]
      +    },
      +    "state": {
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": [
      +    "object",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / backedForfeited
      Added value: +{
      +  "description": "How many of the creator's other launches forfeited their Backed vault. Absent when none.",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / launchesAlive / description
      Previous value: -"Of those, how many still trade"New value: +"Of those, how many still trade (a trade in the last 7 days)"
    • addedOutput schema / properties / launchesUnknown
      Added value: +{
      +  "description": "Of those, how many are neither still trading nor known to have stopped (no trade on record and no word on whether they left their launch curve). Stopped is launchesTotal − launchesAlive − launchesUnknown.",
      +  "type": [
      +    "integer",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / ruleHit
      Added value: +{
      +  "description": "On a `blocked` record, the category of rule that blocked the creator; `definitions.rule` is the one line shown with it",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / supportEmail
      Added value: +{
      +  "description": "On a `blocked` record, where the creator contests the block",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  8. Changed5 schema fields changed
    • changedInput schema / properties / symbol / description
      Previous value: -"The coin's ticker (letters and digits, any case)"New value: +"The coin's ticker (letters and digits, any case), or the token address of a coin nobody registered"
    • addedOutput schema / properties / creator
      Added value: +{
      +  "description": "The creator's wallet, on a coin read by its address (absent on a registered coin)",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / creatorSource
      Added value: +{
      +  "description": "Where the chain names the creator, on a coin read by its address: `launchpad_record` (the\nlaunch program's own record of its creator), `fee_share` (the coin's creator-fee config),\n`launch_pool` (the pool the coin launched in), `mint_authority` (the mint's authority),\n`creation_tx` (sent the creation transaction), `factory_call` (called the contract that\ncreated it) or `payout_recipient` (the coin's payout recipient).\n",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / openBlock / properties / bundledPct / description
      Previous value: -"Percent of supply bought in the opening blocks by wallets buying 3 or more to a block"New value: +"Percent of supply bought in the opening blocks by bundled wallets (3 or more buying in one block, or 2 or more in one block with the same funder)"
    • changedOutput schema / properties / state / description
      Previous value: -"`pending` (not read yet), `first_launch` (no earlier launch found), `on_record` (earlier\nlaunches found), `serial` (many launches, most dead within a week) or `blocked` (refused new\nlaunches here).\n"New value: +"`pending` (not read yet), `first_launch` (no earlier launch found), `on_record` (earlier\nlaunches found), `serial` (many launches, most dead within a week), `blocked` (refused new\nlaunches here) or, for a coin read by its address, `unknown` (the chain names no creator\nChain Daddy can read).\n"
  9. Added

TDQS

A4/5.0
Behavior3/5

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

Annotations already declare this a read-only, idempotent, non-destructive call, and the description adds genuinely useful context beyond them: up to a day of lag behind the chain, `~1 minute` caching, keyless/same-for-everyone semantics, and the browser-only trigger for first-time computation. What it does not clarify is the response envelope, pagination or size of the events list, or what an agent should do while `pending` other than re-ask.

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 first sentence is well front-loaded, but the description runs well over 300 words for a two-parameter read and repeats the pending/`offPlatformPending` semantics across both paragraphs. Several clauses (restating that the answer can be asked again, duplicated caching notes) could be compressed without losing guidance.

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?

An output schema exists, so the field-by-field enumeration is partly redundant, but the state machine (`pending`, `unknown`, `offPlatformPending`) and the 404 conditions are necessary because the schema does not explain them. For a tool with multiple terminal states and a caller-type-dependent branch, coverage is strong.

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%, so the baseline would be 3, but the description adds real meaning: `symbol` may hold a token address and then resolves an unregistered coin, which in turn populates `creator` and `creatorSource`, and non-browser callers get only known data or `pending`. That dual-mode behavior is not evident from the schema alone.

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?

States a specific verb and resource ('Get a verified coin's creator record') and immediately enumerates what the record contains (prior launches, survival/died-within-a-week counts, wallet age and funder, post-launch events, bundled-at-open). That content profile is unique among siblings like get_token and get_token_metrics_summary, so an agent can route correctly without opening any schema.

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

Usage Guidelines4/5

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

Gives concrete selection conditions: the ticker endpoint covers verified coins, while the address form is the path for coins nobody registered. It also spells out when to expect 404, when the record is off entirely, and when a fresh read is only initiated from a browser. It stops short of naming a specific sibling alternative to use instead.

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.

Resources