Skip to main content
FlowMCP v3.0.0 introduces a unified ID format for referencing any element in the catalog: tools, resources, prompts, and lists.
For the full specification, see 16-id-schema.md.

Format

namespace/resourceType/name
ComponentPatternExamples
namespace[a-z][a-z0-9-]*coingecko-com, etherscan, defillama
resourceTypetool, resource, prompt, list
name[a-zA-Z][a-zA-Z0-9]*simplePrice, getContractAbi

Examples

Full FormShort FormContext
coingecko-com/tool/simplePricecoingecko-com/simplePriceTool reference
etherscan/resource/contractsetherscan/contractsResource reference
crypto-research/prompt/token-deep-divePrompt reference
shared/list/evmChainsshared/evmChainsShared list

Short Form

The short form namespace/name is allowed when the resource type is unambiguous:
  • In manifest.tools[] — always means tool
  • In manifest.sharedLists[] — always means list
  • In prompt.dependsOn[] for Agent-Prompts — always means tool

Usage in Placeholders

In prompt content, [[...]] with / is resolved as an ID reference:
Use [[coingecko-com/tool/simplePrice]] to get the price of [[tokenId]].
  • [[coingecko-com/tool/simplePrice]] — Reference (resolved via ID schema)
  • [[tokenId]] — Parameter (user input, no /)

Validation Rules

CodeRule
ID001ID must contain at least one / separator
ID002Namespace must match [a-z][a-z0-9-]*
ID003Resource type (if present) must be tool, resource, prompt, or list
ID004Name must match [a-zA-Z][a-zA-Z0-9]*
ID005Short form allowed only in unambiguous contexts
ID006Reserved namespace shared for shared lists only