Catalog

Dieser Inhalt ist noch nicht in deiner Sprache verfügbar.

A Catalog is the top-level organizational unit in FlowMCP v3. It is a named directory containing a registry.json manifest that describes all shared lists, provider schemas, and agent definitions.

Catalog Structure

flowmcp-community/
├── registry.json           # Catalog manifest
├── _lists/                 # Shared lists (root level)
├── _shared/                # Shared helpers (root level)
├── providers/              # Provider schemas
│   ├── coingecko-com/
│   │   ├── simplePrice.mjs
│   │   └── prompts/
│   └── etherscan/
│       └── contracts.mjs
└── agents/                 # Agent definitions
    ├── crypto-research/
    │   ├── manifest.json
    │   └── prompts/
    └── defi-monitor/
        └── manifest.json

Registry Manifest

The registry.json file declares everything the catalog contains:

{
    "name": "flowmcp-community",
    "version": "3.0.0",
    "description": "Official FlowMCP community catalog",
    "schemaSpec": "3.0.0",
    "shared": [
        { "file": "_lists/evm-chains.mjs", "name": "evmChains" }
    ],
    "schemas": [
        {
            "namespace": "coingecko-com",
            "file": "providers/coingecko-com/simplePrice.mjs",
            "name": "CoinGecko Simple Price",
            "requiredServerParams": [],
            "hasHandlers": false,
            "sharedLists": []
        }
    ],
    "agents": [
        {
            "name": "crypto-research",
            "description": "Cross-provider crypto analysis",
            "manifest": "agents/crypto-research/manifest.json"
        }
    ]
}

Multiple Catalogs

Multiple catalogs can coexist side by side. Each is fully self-contained with no cross-catalog dependencies.

schemas/v3.0.0/
├── flowmcp-community/     # Official catalog
├── my-company-tools/      # Company-internal
└── experimental/          # Personal experiments

Import Flow

# Phase 1: Download catalog
flowmcp import-registry https://example.com/registry.json

# Phase 2: Activate an agent
flowmcp import-agent crypto-research

Validation

flowmcp validate-catalog <catalog-directory>

Code	Rule
CAT001	`registry.json` must exist
CAT002	`name` must match directory name
CAT003	All `shared[].file` paths must resolve
CAT004	All `schemas[].file` paths must resolve
CAT005	All `agents[].manifest` paths must resolve
CAT006	Orphaned files reported as warnings
CAT007	`schemaSpec` must be valid version