io.github.codex-curator/intelligence-aeternum-mcp

Official13 tools

by codex-curator · Python

Intelligence Aeternum

AI training dataset marketplace: 2M+ museum artworks with Golden Codex enrichment

AI training dataset marketplace with 2M+ museum artworks and enriched metadata.

Topics

aiai-training-datadatasetsmarketplacemcpmcp-serverprovenancex402golden-codexmuseum-art

Captured live from the server via tools/list.

search_alexandria

FREE — Search 2M+ museum artworks in the Alexandria Aeternum catalog. Searches the Firestore manifest (primary) with Vertex AI fallback. Returns artifact IDs, titles, artists, dates, and classification. Use get_curated_metadata() for Human_Standard metadata + image (5 free/day). Use get_oracle_metadata() for Hybrid_Premium VLM deep analysis + image. Args: query: Free-text search (e.g., "impressionist landscape", "Rembrandt portrait"). museum: Filter by museum: met, nga, chicago, cleveland, rijksmuseum, smithsonian, paris. limit: Max results (default 20, max 100).

Parameters (3)

querystringrequired
museumstring
limitinteger

get_curated_metadata

FREE (5/day) — Get Human_Standard metadata + image for an artifact. Returns 500-1,200 tokens of 100% human-sourced metadata PLUS a signed image download URL. Every response is a package: metadata + image together. Zero synthetic content. Sources: Museum API + Wikipedia + Wikidata + Getty ULAN. After 5 free requests per day, requires $0.05 USDC via x402. Args: artifact_id: The artifact ID (e.g., "met_10049", "nga_1234").

Parameters (1)

artifact_idstringrequired

get_oracle_metadata

PAID — Get Hybrid_Premium metadata + image with VLM deep visual analysis. Returns 2,000-6,000 tokens including everything in Human_Standard PLUS: visual_analysis, emotional_and_thematic_journey, deep symbolism, and archetypal analysis. Image download URL included in response. Args: artifact_id: The artifact ID (e.g., "met_10049").

Parameters (1)

artifact_idstringrequired

get_compliance_manifest

FREE — Get auto-generated regulatory compliance manifests for a dataset. Returns AB 2013 (California) and/or EU AI Act Article 53 provenance manifests. "Buy from us, get instant California + EU AI compliance." Args: dataset_id: The dataset ID (e.g., "met-museum", "rijksmuseum"). regulation: Which regulation: "ab2013", "eu_ai_act", or "all" (default).

Parameters (2)

dataset_idstringrequired
regulationstring

get_agent_guide

FREE — Get complete API workflow documentation for agents. Returns the full agent guide with endpoints, pricing, custom fields schema, volume discounts, and recommended workflow.

No parameters.

search_datasets

FREE — Search the Alexandria Aeternum dataset catalog (7 museums, 1.6M+ images).

Parameters (3)

querystring
domainstring
min_imagesinteger

preview_dataset

FREE (10/day) — Preview sample images from a dataset.

Parameters (2)

dataset_idstringrequired
limitinteger

get_pricing

FREE — Get pricing information for a dataset purchase. Args: dataset_id: The dataset ID. quantity: Number of images to price.

Parameters (2)

dataset_idstringrequired
quantityinteger

purchase_dataset

Initiate a dataset purchase (x402 or Stripe).

Parameters (3)

dataset_idstringrequired
quantityintegerrequired
payment_methodstring

list_enrichment_tiers

FREE — List available enrichment tiers for agent-submitted images. NEW: Submit YOUR images via POST /agent/enrich with custom fields. Your metadata is merged with Oracle analysis. Submitter values take priority.

No parameters.

enrich_agent_image

Submit YOUR image for Golden Codex enrichment (Enrichment-as-a-Service). Tiers: - oracle_only: Returns Golden Codex JSON (111-field Hybrid_Premium analysis) - oracle_plus_infuse: JSON + XMP-infused image + GCX hash registry - full_certified: JSON + infused + C2PA signed + hash registered Custom fields are merged with Hybrid_Premium analysis. Submit as JSON string. Your values take priority for factual fields (title, artist, copyright). Args: image_url: Public URL of the image to enrich. tier: oracle_only, oracle_plus_infuse, or full_certified. callback_url: Optional webhook URL for completion notification. custom_fields: JSON string of custom metadata fields to merge.

Parameters (4)

image_urlstringrequired
tierstring
callback_urlstring
custom_fieldsstring

deliver_artifacts

Create an on-demand delivery order for specific manifest artifacts. Artifacts are fetched from museum APIs, optimized, enriched (Nova + Atlas), and bundled into a single downloadable archive. Supports up to 10,000 artifacts per order with automatic volume discounts. Args: artifact_ids: Comma-separated artifact IDs (e.g., "met_436965,chicago_27992"). Up to 10,000 per order. tier: Delivery tier: human_standard ($0.05) or hybrid_premium ($0.20). format: Output format: 'tar.gz' (default, best for ML pipelines), 'zip' (best for humans), or 'urls' (legacy individual signed URLs).

Parameters (3)

artifact_idsstringrequired
tierstring
formatstring

get_enrichment_status

Poll the status of a Golden Codex enrichment job. Args: job_id: The job ID returned from the enrich endpoint.

Parameters (1)

job_idstringrequired

README.md10 KBView on GitHub

Intelligence Aeternum MCP

AI training dataset marketplace exposed as MCP servers. 2M+ museum artworks across 7 world-class institutions with on-demand 111-field Golden Codex AI enrichment. AI agents pay with x402 USDC on Base L2. Human buyers pay with Stripe.

Quick Start

Connect to the MCP endpoint with any MCP-compatible client:

json

{
  "mcpServers": {
    "intelligence-aeternum": {
      "url": "https://data-portal-172867820131.us-west1.run.app/mcp",
      "transport": "streamable-http"
    }
  }
}

Or use the MonetizedMCP broker (x402 payment orchestration):

json

{
  "mcpServers": {
    "fluora-mcp": {
      "url": "https://fluora-mcp-172867820131.us-west1.run.app/mcp",
      "transport": "streamable-http"
    }
  }
}

Architecture

code

AI Agent (Claude, GPT, etc.)
    |
    +---> Fluora MCP (MonetizedMCP broker)         [TypeScript/Express]
    |     3 tools: price-listing, payment-methods, make-purchase
    |     Orchestrates x402 USDC payments via MonetizedMCP SDK
    |     Proxies to Data Portal with payment proof
    |
    +---> Data Portal MCP (FastMCP content server)  [Python/FastAPI]
          13 tools: search, metadata, oracle, enrichment, compliance...
          Serves 2M+ artworks from Firestore manifest
          On-demand VLM enrichment via Gemini

Human Buyer (Browser)
    |
    +---> Data Portal REST API / golden-codex.com
          Stripe checkout for dataset purchases and enrichment
          Same artifact delivery pipeline as x402

Services

Data Portal (13 MCP Tools)

Tool	Paid?	Description
`search_alexandria`	Free	Search 2M+ museum artworks across 7 institutions
`get_curated_metadata`	Free (5/day)	Human_Standard metadata + image (500-1,200 tokens)
`get_oracle_metadata`	$0.16 USDC	Hybrid_Premium 111-field VLM deep analysis + image
`get_compliance_manifest`	Free	AB 2013 + EU AI Act Article 53 compliance manifests
`search_datasets`	Free	Browse 7 museum dataset catalogs
`preview_dataset`	Free	Sample images from a dataset
`get_pricing`	Free	Calculate pricing with volume discounts
`get_agent_guide`	Free	Complete API workflow documentation
`list_enrichment_tiers`	Free	Available enrichment tiers and pricing
`get_enrichment_status`	Free	Poll enrichment job status
`purchase_dataset`	Paid	Initiate batch dataset purchase
`enrich_agent_image`	From $0.16	Submit YOUR image for Golden Codex enrichment
`deliver_artifacts`	From $0.04	On-demand artifact delivery

Fluora MCP (MonetizedMCP Broker)

Tool	Description
`price-listing`	Browse 7 purchasable data products with pricing
`payment-methods`	Get accepted payment methods (x402 USDC for agents, Stripe for humans)
`make-purchase`	Purchase data with x402 USDC micropayment

Pipeline Tools (Coming to MCP)

Tool	Description	Price
SD 3.5 Large + T5-XXL	Image generation on NVIDIA L4 GPU with LoRA support	TBD
ESRGAN x4 Upscaler	Real-ESRGAN super-resolution (1024px to 4096px in ~1.15s)	$0.10
Nova (Metadata Creation)	111-field Golden Codex VLM analysis via Gemini	$0.20
Atlas (Metadata Infusion)	XMP/IPTC/C2PA embedding + SHA-256 Soulmark + hash registry	$0.10
Aegis (Verification)	"Shazam for Art" — perceptual hash provenance lookup	Free
Archivus (Arweave Storage)	Permanent 200+ year storage — pay USDC, no AR needed	TBD
Mintra (NFT Minting)	Polygon NFT with full Golden Codex metadata on-chain	TBD

Museums

Institution	Artworks	License
Metropolitan Museum of Art	375,000	CC0
Rijksmuseum	709,000	CC0
Smithsonian Institution	185,000	CC0
National Gallery of Art	130,000	CC0
Art Institute of Chicago	120,000	CC0
Cleveland Museum of Art	61,000	CC0
Paris Collections (Louvre, Orsay, Rodin)	45,000	CC0

All source images are CC0/public domain. Enrichment metadata is commercially licensed by Metavolve Labs.

Payment

Two payment paths -- one marketplace, two buyer types:

AI agents pay with x402 USDC micropayments on Base L2. No API keys, no subscriptions -- agents pay autonomously per request.
Human buyers pay with Stripe checkout. Credit/debit cards, Apple Pay, Google Pay -- standard web checkout for dataset purchases and enrichment orders.

x402 Flow (AI Agents)

Call a paid tool without payment
Receive HTTP 402 with x402 payment envelope
Execute USDC transfer on Base L2
Re-call with X-PAYMENT header containing transaction proof
Receive data

Wallet: 0xFE141943a93c184606F3060103D975662327063B

Stripe Flow (Human Buyers)

Select data products or enrichment services
Complete Stripe checkout (cards, Apple Pay, Google Pay)
Receive artifacts via the same delivery pipeline

Genesis Epoch (Launch Pricing)

20% off all prices for 90 days (started Feb 23, 2026).

Volume discounts auto-apply per wallet:

100+ records: 25% off
500+ records: 37% off
2000+ records: 50% off

Discovery

Endpoint	URL
Data Portal MCP	`https://data-portal-172867820131.us-west1.run.app/mcp`
Fluora MCP	`https://fluora-mcp-172867820131.us-west1.run.app/mcp`
OpenAPI Docs	`https://data-portal-172867820131.us-west1.run.app/docs`
llms.txt (Data Portal)	`https://data-portal-172867820131.us-west1.run.app/llms.txt`
llms.txt (Fluora)	`https://fluora-mcp-172867820131.us-west1.run.app/llms.txt`
.well-known/mcp.json	`https://data-portal-172867820131.us-west1.run.app/.well-known/mcp.json`
Schema (Fluora)	`https://fluora-mcp-172867820131.us-west1.run.app/mcp/schema`
Health (Data Portal)	`https://data-portal-172867820131.us-west1.run.app/health`
Health (Fluora)	`https://fluora-mcp-172867820131.us-west1.run.app/health`

Research

Our peer-reviewed paper The Density Imperative demonstrates that dense metadata significantly impacts VLM capability:

+25.5% improvement with 111-field Golden Codex enrichment
-54.4% degradation with sparse 10-20 word captions
+160% semantic coverage vs raw captions

Paper: DOI: 10.5281/zenodo.18667735

Directory Structure

code

intelligence-aeternum-mcp/
+-- fluora-mcp/              # MonetizedMCP broker (TypeScript/Express)
|   +-- src/
|   |   +-- main.ts          # Entrypoint
|   |   +-- server/
|   |   |   +-- server.ts    # MCP server + HTTP endpoints
|   |   |   +-- purchasableItems.ts  # 7 product catalog
|   |   |   +-- paymentMethods.ts    # USDC on Base L2
|   |   +-- config/
|   |       +-- config.ts    # Environment config
|   +-- Dockerfile
|   +-- package.json
|   +-- deploy.sh
|
+-- data-portal/             # FastMCP content server (Python/FastAPI)
|   +-- main.py              # FastAPI app + MCP mount
|   +-- mcp_server.py        # 13 MCP tool definitions
|   +-- auth.py              # x402 payment verification + rate limiting
|   +-- pricing.py           # Pricing tiers + Genesis Epoch
|   +-- compliance.py        # AB 2013 + EU AI Act manifests
|   +-- volume_tracker.py    # Per-wallet volume discounts
|   +-- image_fetcher.py     # Museum API integration
|   +-- routes/
|   |   +-- agent.py         # Agent API endpoints
|   |   +-- reader.py        # Verilian Reader (decode XMP metadata)
|   |   +-- catalog.py       # Dataset catalog
|   |   +-- orders.py        # Stripe + x402 orders
|   |   +-- enrich.py        # Enrichment-as-a-Service
|   |   +-- deliver.py       # On-demand delivery
|   |   +-- admin.py         # Admin utilities
|   +-- Dockerfile
|   +-- requirements.txt
|   +-- deploy.sh
|
+-- glama.json               # Glama.ai MCP directory manifest
+-- README.md                # This file

Compliance

Every purchase auto-generates provenance manifests at no additional cost:

AB 2013 (California AI Training Data Transparency Act)
EU AI Act Article 53 (Training data documentation requirements)

Enterprise

Full dataset access with compliance manifests starting at $8,000.

Contact: enterprise@iaeternum.ai

Important: What You're Paying For

Pricing applies to structured AI training metadata only -- not the source images. All 2M+ source artworks are CC0/public domain from partner museums and freely available from their original APIs. What Intelligence Aeternum provides is:

Golden Codex enrichment: 111-field NEST metadata generated by multi-model VLM analysis (Gemini + Claude + GPT-4o)
Compliance manifests: Auto-generated AB 2013 + EU AI Act Article 53 documentation
Pipeline services: Upscaling, metadata infusion, C2PA signing, hash registration, permanent storage
Structured datasets: Pre-enriched collections optimized for AI training workflows

License

Source code in this repository is provided for reference and transparency. The enrichment metadata, Golden Codex schema, and pipeline services are proprietary to Metavolve Labs, Inc. Source images from museums are CC0/public domain.

Install

claude_desktop_config.json

{
  "mcpServers": {
    "intelligence-aeternum-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://data-portal-172867820131.us-west1.run.app/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

Topics

search_alexandria

get_curated_metadata

get_oracle_metadata

get_compliance_manifest

get_agent_guide

search_datasets

preview_dataset

get_pricing

purchase_dataset

list_enrichment_tiers

enrich_agent_image

deliver_artifacts

get_enrichment_status

Intelligence Aeternum MCP

Quick Start

Architecture

Services

Data Portal (13 MCP Tools)

Fluora MCP (MonetizedMCP Broker)

Pipeline Tools (Coming to MCP)

Museums

Payment

x402 Flow (AI Agents)

Stripe Flow (Human Buyers)

Genesis Epoch (Launch Pricing)

Discovery

Research

Directory Structure

Compliance

Enterprise

Important: What You're Paying For

License

Links

Install