このMCPでできること
Supports searching and browsing a curated collection of memes, infographics, and other visual content.
機能
ツール
21
ツール
browse_by_category
Get a category and its featured images. Categories group related tags (e.g. "charts", "memes", "lightning-network").
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['category'], 'properties': {'category': {'type': 'string', 'description': 'Category slug (e.g. "charts", "memes")'}}}
出力スキーマ
{'type': 'object', 'required': ['featured_images'], 'properties': {'name': {'type': 'string', 'description': 'Category display name.'}, 'slug': {'type': 'string', 'description': 'Category slug.'}, 'description': {'type': ['string', 'null'], 'description': 'Category description.'}, 'featured_images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Featured images in the category.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'A category profile plus its featured images and combined citations.', 'additionalProperties': True}
browse_by_tag
Browse images for a specific tag. Returns the tag profile (description, stats) and optionally a paginated list of images tagged with it. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['tag'], 'properties': {'tag': {'type': 'string', 'description': 'Tag slug (e.g. "bitcoin", "meme", "lightning")'}, 'limit': {'type': 'number', 'description': 'Images per page (1-50, default 10). When provided, images are included in the response.'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images'], 'properties': {'name': {'type': 'string', 'description': 'Tag display name.'}, 'slug': {'type': 'string', 'description': 'Tag slug.'}, 'total': {'type': 'number', 'description': 'Total matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images with this tag.'}, 'description': {'type': ['string', 'null'], 'description': 'Tag description.'}, 'image_count': {'type': 'number', 'description': 'Number of images with this tag.'}, 'related_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related tag slugs.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'A tag profile plus its images and combined citations.', 'additionalProperties': True}
browse_images
Browse and filter the image gallery without a search query. Useful for discovering content by tag, trending, or recent uploads. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Filter by tag slug (e.g. "bitcoin", "meme")'}, 'sort': {'enum': ['newest', 'popular', 'oldest', 'trending'], 'type': 'string', 'description': 'Sort order (default: newest)'}, 'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images', 'total'], 'properties': {'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images in the requested view.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
cite_image
Generate canonical attribution blocks for one or more MemeStack images. Returns markdown, HTML, and plain-text citation strings ready to paste into your output, plus a combined block for citing multiple images at once.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['image_ids'], 'properties': {'image_ids': {'type': 'array', 'items': {'type': 'string'}, 'maxItems': 50, 'minItems': 1, 'description': 'Up to 50 image UUIDs'}}}
出力スキーマ
{'type': 'object', 'required': ['citations', 'combined', 'missing_ids'], 'properties': {'combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}, 'citations': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'markdown', 'html', 'plain'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}}, 'additionalProperties': True}, 'description': 'One citation per resolved image ID.'}, 'missing_ids': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Requested IDs that could not be resolved.'}}, 'description': 'Per-image and combined citations for the requested image IDs.', 'additionalProperties': True}
find_meme_for_text
Find a meme that captures a vibe, idea, or concept. Returns ready-to-embed images with citation blocks. Use this when writing posts, articles, or social content and you need a meme to illustrate a point. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['vibe'], 'properties': {'vibe': {'type': 'string', 'description': 'The vibe, topic, or idea you want a meme for'}, 'limit': {'type': 'number', 'description': 'How many memes to return (1-20, default 5)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Memes that capture the requested vibe.'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'query_language': {'type': 'string', 'description': 'Present with translated_query: the ISO 639-1 code of the query language, e.g. "fr".'}, 'translated_query': {'type': 'string', 'description': 'Present only when the query was not English: the English text it was also searched as (those results are merged in).'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
find_related
Find semantically related images using AI embedding similarity. Returns images with similar meaning/topic. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Source image UUID'}, 'limit': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'similarity': {'type': 'number', 'description': 'Visual-similarity score (find_similar / reverse_image_search).'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'relevance_score': {'type': 'number', 'description': 'Semantic-relevance score (find_related).'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (compact fields) with a ranking score and attribution.', 'additionalProperties': True}, 'description': 'Semantically related images.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
find_similar
Find visually similar images using perceptual hash matching. Returns images that look alike. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Source image UUID'}, 'limit': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images', 'count'], 'properties': {'count': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'similarity': {'type': 'number', 'description': 'Visual-similarity score (find_similar / reverse_image_search).'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'relevance_score': {'type': 'number', 'description': 'Semantic-relevance score (find_related).'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (compact fields) with a ranking score and attribution.', 'additionalProperties': True}, 'description': 'Visually similar images.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
generate_meme
Generate a new image from a text prompt using AI (Grok Imagine). Paid tool - billed per call via the agent payment rails (x402/L402); not covered by any free quota. Generation runs asynchronously on the server and this call polls until it completes, up to ~90 seconds. If you get a "still running" error, call the tool again with the SAME payment proof to resume polling - you will never be charged twice for one payment. Note for x402 clients: "quality" mode (~$0.15) exceeds the agents-SDK default per-call cap of $0.10 - raise maxPaymentValue in withX402Client to use it.
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['prompt'], 'properties': {'mode': {'enum': ['standard', 'quality'], 'type': 'string', 'description': 'Generation quality tier - "standard" (default, cheaper) or "quality" (higher fidelity, costs more).'}, 'prompt': {'type': 'string', 'maxLength': 2000, 'description': 'Text description of the image to generate (max 2000 characters).'}, 'aspect_ratio': {'enum': ['1:1', '3:4', '16:9'], 'type': 'string', 'description': 'Output image aspect ratio (default "1:1").'}}}
出力スキーマ
{'type': 'object', 'required': ['image_id', 'url', 'image_url', 'thumbnail_url'], 'properties': {'url': {'type': 'string', 'description': 'MemeStack gallery page URL for the generated image.'}, 'tags': {'type': 'array', 'items': {'type': 'object'}, 'description': 'Scored tags assigned to the generated image.'}, 'caption': {'type': ['string', 'null'], 'description': 'AI-generated caption for the image.'}, 'image_id': {'type': 'string', 'description': 'UUID of the generated image.'}, 'image_url': {'type': 'string', 'description': 'Direct serve URL for the full generated image bytes.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail URL for the generated image.'}}, 'description': 'The AI-generated image produced by a paid generate_meme call.', 'additionalProperties': True}
get_image
Get full metadata for a specific image by ID, including caption, alt text, tags, OCR text, zap stats, and URLs. For a chart that is part of a series, chart.series lists every edition (other years) by id.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['id'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID'}}}
出力スキーマ
{'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'size': {'type': 'number', 'description': 'File size in bytes.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'alt_text': {'type': 'string', 'description': 'Accessible alt text.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'mime_type': {'type': 'string', 'description': 'Image MIME type.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 last-updated timestamp.'}, 'thumb_width': {'type': 'number', 'description': 'Thumbnail width in pixels.'}, 'thumb_height': {'type': 'number', 'description': 'Thumbnail height in pixels.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'quality_score': {'type': 'number', 'description': 'AI quality score (1-10).'}, 'text_in_image': {'type': ['string', 'null'], 'description': 'OCR transcription of any text in the image.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (full detail) with OCR text, dimensions, and attribution.', 'additionalProperties': True}
get_leaderboard
Get top-ranked images by zaps received, or top zappers by amount zapped, over a time period.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['type'], 'properties': {'type': {'enum': ['images', 'zappers'], 'type': 'string', 'description': 'Leaderboard type'}, 'period': {'enum': ['day', 'week', 'month', 'all'], 'type': 'string', 'description': 'Time period (default: week)'}}}
出力スキーマ
{'type': 'object', 'properties': {'users': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'User UUID.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 account-creation timestamp.'}, 'has_avatar': {'type': 'boolean', 'description': 'Whether the user has an avatar.'}, 'display_name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'approved_image_count': {'type': 'number', 'description': 'Number of approved uploads.'}}, 'description': 'A public user profile (pubkey and role omitted).', 'additionalProperties': True}, 'description': 'Top zappers (zappers leaderboard).'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Top images (images leaderboard).'}, 'period': {'type': 'string', 'description': 'The leaderboard period.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'Leaderboard results — `images` for the images board, `users` for the zappers board.', 'additionalProperties': True}
get_mutation_group
Get all variants of a meme template tracked on MemeStack. Returns the dominant image plus every variant in the same mutation group, with citation blocks for each. Use this to research how a meme has evolved or to find variants of a known image.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['image_id'], 'properties': {'image_id': {'type': 'string', 'description': 'Image UUID'}}}
出力スキーマ
{'type': 'object', 'required': ['dominant', 'variants'], 'properties': {'dominant': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'size': {'type': 'number', 'description': 'File size in bytes.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'alt_text': {'type': 'string', 'description': 'Accessible alt text.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'mime_type': {'type': 'string', 'description': 'Image MIME type.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'updated_at': {'type': 'string', 'description': 'ISO 8601 last-updated timestamp.'}, 'thumb_width': {'type': 'number', 'description': 'Thumbnail width in pixels.'}, 'thumb_height': {'type': 'number', 'description': 'Thumbnail height in pixels.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'quality_score': {'type': 'number', 'description': 'AI quality score (1-10).'}, 'text_in_image': {'type': ['string', 'null'], 'description': 'OCR transcription of any text in the image.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (full detail) with OCR text, dimensions, and attribution.', 'additionalProperties': True}, 'variants': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Variant images in the group.'}, 'total_variants': {'type': 'number', 'description': 'Number of variants.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'A meme-evolution group: the dominant image plus its variants.', 'additionalProperties': True}
get_tag_profile
Get the profile for a tag (description, image count, total zaps, related tags) without fetching any images. Use browse_by_tag to also retrieve images.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['tag'], 'properties': {'tag': {'type': 'string', 'description': 'Tag slug (e.g. "bitcoin", "meme")'}}}
出力スキーマ
{'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Tag display name.'}, 'slug': {'type': 'string', 'description': 'Tag slug.'}, 'description': {'type': ['string', 'null'], 'description': 'Tag description.'}, 'image_count': {'type': 'number', 'description': 'Number of images with this tag.'}, 'related_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Related tag slugs.'}}, 'description': 'A tag profile (description, related tags, stats) without images.', 'additionalProperties': True}
get_user_profile
Get a user's public profile including display name, stats, and avatar info.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['identifier'], 'properties': {'identifier': {'type': 'string', 'description': 'User public key (hex) or UUID'}}}
出力スキーマ
{'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'User UUID.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 account-creation timestamp.'}, 'has_avatar': {'type': 'boolean', 'description': 'Whether the user has an avatar.'}, 'display_name': {'type': ['string', 'null'], 'description': 'Display name.'}, 'approved_image_count': {'type': 'number', 'description': 'Number of approved uploads.'}}, 'description': 'A public user profile (pubkey and role omitted).', 'additionalProperties': True}
list_categories
List all available image categories. Use this to discover what categories exist before calling browse_by_category.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'properties': {}}
出力スキーマ
{'type': 'object', 'properties': {'categories': {'type': 'array', 'items': {'type': 'object', 'properties': {'name': {'type': 'string', 'description': 'Display name.'}, 'slug': {'type': 'string', 'description': 'Category slug.'}, 'description': {'type': 'string', 'description': 'Category description.'}, 'image_count': {'type': 'number', 'description': 'Number of images in the category.'}}, 'description': 'A content category.', 'additionalProperties': True}, 'description': 'The full category list.'}}, 'description': 'All content categories.', 'additionalProperties': True}
popular_tags
List the most-used tags on MemeStack by all-time usage count. (Time-period filtering is not yet supported - tag usage is currently counted across the full lifetime of each tag.)
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'properties': {'limit': {'type': 'number', 'description': 'How many tags to return (1-100, default 20)'}}}
出力スキーマ
{'type': 'object', 'properties': {'tags': {'type': 'array', 'items': {'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Tag slug.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'usage_count': {'type': 'number', 'description': 'Number of images using this tag.'}}, 'description': 'A tag with usage stats.', 'additionalProperties': True}, 'description': 'Tags ordered by usage.'}}, 'description': 'The most-used tags by image count.', 'additionalProperties': True}
reverse_image_search
Find MemeStack images that look visually similar to a given image. Accepts an HTTPS image URL or a `data:image/...;base64,...` URL for bytes pasted into agent context. Returns visually-similar matches via perceptual-hash (dHash) hamming distance, with citation blocks. Heavily rate-limited (10/min/IP) since each call hashes the input. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['url'], 'properties': {'url': {'type': 'string', 'description': 'HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL'}, 'limit': {'type': 'number', 'description': 'Max results (1-20, default 10)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['similar'], 'properties': {'similar': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'similarity': {'type': 'number', 'description': 'Visual-similarity score (find_similar / reverse_image_search).'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'relevance_score': {'type': 'number', 'description': 'Semantic-relevance score (find_related).'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (compact fields) with a ranking score and attribution.', 'additionalProperties': True}, 'description': 'Visually similar images.'}, 'input_meta': {'type': 'object', 'properties': {'phash': {'type': 'string', 'description': 'Perceptual hash of the input.'}, 'mime_type': {'type': 'string', 'description': 'Input MIME type.'}, 'size_bytes': {'type': 'number', 'description': 'Input size in bytes.'}}, 'description': 'Computed metadata for the input image.', 'additionalProperties': True}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'description': 'Visually similar gallery images for the input image, plus input metadata.', 'additionalProperties': True}
search_charts
Search charts, maps and infographics that carry structured source metadata - the publishing dataset and its academic citation, the unit, the regions plotted, and the period the chart actually displays (never the dataset's wider history). Results say whether the source has published newer data since the image was captured. browse_by_tag, browse_by_category, get_leaderboard and get_mutation_group return images WITHOUT this metadata; the other search and image tools include it whenever a row exists. This tool covers only images that HAVE stored metadata, so use search_images for the widest chart coverage. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'What the chart should show, in plain words - e.g. "global cereal yields" or "life expectancy by country".'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'region': {'type': 'string', 'description': 'Restrict to charts that plot this entity exactly as the chart names it, e.g. "World", "Germany".'}, 'data_to': {'type': 'number', 'description': 'Latest year of interest. See data_from.'}, 'data_from': {'type': 'number', 'description': "Earliest year of interest. Matches charts whose DISPLAYED period overlaps [data_from, data_to]. Charts with no provable displayed period are excluded, and the underlying dataset's wider history is never used for this test."}, 'chart_source': {'type': 'string', 'description': 'Restrict to one upstream source key: "owid" (Our World in Data), "usda_ers" (USDA Economic Research Service), "eurostat" or "eea" (European Environment Agency).'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images', 'total'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images that HAVE stored chart metadata, best-first. Every item carries a populated chart block (source, citation, unit, regions, displayed period).'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'query_language': {'type': 'string', 'description': 'Present with translated_query: the ISO 639-1 code of the query language, e.g. "fr".'}, 'translated_query': {'type': 'string', 'description': 'Present only when the query was not English: the English text it was also searched as (those results are merged in).'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
search_images
Search the MemeStack image gallery. Runs semantic AI and keyword matching in parallel and merges results. Returns images with captions, tags, zap stats, and URLs. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['query'], 'properties': {'q': {'type': 'string', 'description': 'Alias for `query`. Provided so REST-API muscle memory (?q=...) works on the MCP tool too. If both are set, `query` wins.'}, 'tag': {'type': 'string', 'description': 'Filter results by a single tag slug (backward compat)'}, 'sort': {'enum': ['newest', 'popular', 'oldest'], 'type': 'string', 'description': 'Sort order (default: relevance)'}, 'tags': {'type': 'string', 'description': 'Filter results by multiple tag slugs (comma-separated, AND logic - e.g. "bitcoin,meme")'}, 'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'Search query - combines semantic AI and keyword matching automatically. Alias: `q` (matches the REST API param name).'}, 'offset': {'type': 'number', 'description': 'Pagination offset (default 0)'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images', 'total'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Matching images, best-first.'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'query_language': {'type': 'string', 'description': 'Present with translated_query: the ISO 639-1 code of the query language, e.g. "fr".'}, 'translated_query': {'type': 'string', 'description': 'Present only when the query was not English: the English text it was also searched as (those results are merged in).'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
search_text_in_image
Search for images by the text written or printed in them (OCR). Different from regular search - only matches the text_in_image field, not captions or tags. Use this to find screenshots of specific quotes, signs, watermarks, or memes with specific embedded text. Results exclude images classified controversial unless include_controversial is true.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['query'], 'properties': {'limit': {'type': 'number', 'description': 'Results per page (1-50, default 10)'}, 'query': {'type': 'string', 'description': 'Text to search for in image OCR'}, 'offset': {'type': 'number', 'description': 'Pagination offset'}, 'include_controversial': {'type': 'boolean', 'description': 'Include images classified controversial (excluded by default).'}}}
出力スキーマ
{'type': 'object', 'required': ['images', 'total'], 'properties': {'note': {'type': 'string', 'description': 'Present when the first page has no strong result: says so and that the results are the closest available.'}, 'total': {'type': 'number', 'description': 'Total number of matching images.'}, 'images': {'type': 'array', 'items': {'type': 'object', 'required': ['id', 'thumbnail_url', 'canonical_url', 'page_url', 'citation'], 'properties': {'id': {'type': 'string', 'description': 'Image UUID.'}, 'tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Topic tag slugs.'}, 'chart': {'type': ['object', 'null'], 'properties': {'unit': {'type': ['string', 'null'], 'description': 'Measurement unit, when the underlying indicators agree on one.'}, 'title': {'type': ['string', 'null'], 'description': 'Chart title as published upstream.'}, 'series': {'type': 'array', 'items': {'type': 'object', 'properties': {'id': {'type': 'string', 'description': 'Image id of the edition.'}, 'published_at': {'type': ['string', 'null'], 'description': 'Release date.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year shown.'}, 'start': {'type': 'number', 'description': 'First year shown.'}}, 'additionalProperties': True}}, 'additionalProperties': True}, 'description': 'Every visible edition of this chart, newest first (get_image only).'}, 'source': {'type': 'string', 'description': 'Upstream source key: "owid", "usda_ers", "eurostat" or "eea".'}, 'regions': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Entities plotted, exactly as the chart names them (e.g. "World", "Germany").'}, 'provenance': {'enum': ['authoritative', 'extracted'], 'type': 'string', 'description': "How this metadata was captured: read from the source's own structured feed ('authoritative'), or read off the chart image itself ('extracted')."}, 'series_key': {'type': ['string', 'null'], 'description': 'Editions of one chart share this key; null when the chart is not part of a series.'}, 'source_url': {'type': ['string', 'null'], 'description': 'Canonical URL for the chart at its upstream source.'}, 'superseded': {'type': 'boolean', 'description': 'True when the upstream source has published data newer than this snapshot.'}, 'published_at': {'type': ['string', 'null'], 'description': "The publisher's release date for this edition (YYYY-MM-DD)."}, 'citation_long': {'type': ['string', 'null'], 'description': 'Full academic citation for the upstream dataset.'}, 'citation_short': {'type': ['string', 'null'], 'description': 'Short attribution line for the upstream dataset.'}, 'rendered_period': {'type': ['object', 'null'], 'properties': {'end': {'type': 'number', 'description': 'Last year the chart displays.'}, 'start': {'type': 'number', 'description': 'First year the chart displays.'}, 'evidence': {'type': 'string', 'description': 'OCR substring the period was grounded on.'}}, 'description': 'The period the chart PROVABLY displays, grounded in its own OCR text - null when no period could be proven. Never a guess, and never the wider history in dataset_timespan.', 'additionalProperties': True}, 'dataset_timespan': {'type': ['object', 'null'], 'properties': {'end': {'type': ['number', 'null'], 'description': 'Latest year in the dataset, when known.'}, 'raw': {'type': ['string', 'null'], 'description': 'The dataset timespan as published upstream, verbatim.'}, 'start': {'type': ['number', 'null'], 'description': 'Earliest year in the dataset, when known.'}}, 'description': "The underlying dataset's own history - display-only context, NOT the period this chart shows (see rendered_period). Never usable as a date filter.", 'additionalProperties': True}}, 'description': 'Structured source metadata for a chart, map or infographic, present only when MemeStack holds a record for this image (an image_chart_meta row). Absent or null means no stored metadata - never a signal that the image is not a chart.', 'additionalProperties': True}, 'match': {'enum': ['strong', 'closest'], 'type': 'string', 'description': 'Honest search: strong = a real answer, closest = the nearest miss. Present only when the API labelled the result.'}, 'width': {'type': 'number', 'description': 'Original width in pixels.'}, 'height': {'type': 'number', 'description': 'Original height in pixels.'}, 'caption': {'type': 'string', 'description': 'AI-generated caption.'}, 'citation': {'type': 'object', 'required': ['site', 'page_url', 'markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Attribution as HTML.'}, 'site': {'type': 'string', 'description': 'Always "MemeStack".'}, 'plain': {'type': 'string', 'description': 'Attribution as plain text.'}, 'markdown': {'type': 'string', 'description': 'Attribution as Markdown.'}, 'page_url': {'type': 'string', 'description': 'Canonical MemeStack gallery page for the image.'}, 'site_url': {'type': 'string', 'description': 'The MemeStack site URL.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'source_origin': {'type': ['string', 'null'], 'description': "Origin: 'owid' | 'usda_ers' | 'eurostat' | 'eea' | 'imgflip' | '4chan' | 'telegram' | 'generated' | 'mcp' | 'x' | 'unknown' | null (null = a direct upload)."}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'academic_citation': {'type': 'string', 'description': 'Full upstream academic citation, present only when the image has stored chart metadata with one.'}, 'source_external_url': {'type': ['string', 'null'], 'description': "External source URL — the Our World in Data chart, the chart publisher's page, or the X post; null otherwise."}, 'attribution_required': {'type': 'boolean', 'description': "True when the licence or the rights holder requires attribution: Our World in Data, the chart publishers (USDA ERS, Eurostat, EEA), and a verified creator's own work."}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null when absent/withheld.'}, 'attribution_recommended': {'type': 'boolean', 'description': 'Always true — attribution is recommended.'}}, 'description': 'Ready-to-paste attribution for this image in three formats, plus source metadata.', 'additionalProperties': True}, 'page_url': {'type': 'string', 'description': 'MemeStack gallery page URL.'}, 'free_tags': {'type': 'array', 'items': {'type': 'string'}, 'description': 'Free-form tag slugs.'}, 'zap_count': {'type': 'number', 'description': 'Number of Lightning zaps.'}, 'created_at': {'type': 'string', 'description': 'ISO 8601 creation timestamp.'}, 'like_count': {'type': 'number', 'description': 'Number of likes.'}, 'save_count': {'type': 'number', 'description': 'Number of saves.'}, 'canonical_url': {'type': 'string', 'description': 'Full-resolution image URL.'}, 'controversial': {'type': 'boolean', 'description': 'True when MemeStack classifies the image as controversial (likely to offend or divide a general audience). The list tools exclude such images unless include_controversial is true; by-id tools always answer and carry this flag. Absent when the API answer predates the flag.'}, 'thumbnail_url': {'type': 'string', 'description': 'Thumbnail image URL.'}, 'zap_total_sats': {'type': 'number', 'description': 'Total sats zapped.'}, 'meme_template_name': {'type': ['string', 'null'], 'description': 'Recognised meme template, if any.'}, 'uploader_display_name': {'type': ['string', 'null'], 'description': 'Uploader name, or null.'}}, 'description': 'A gallery image (lean list fields) with attribution.', 'additionalProperties': True}, 'description': 'Images whose OCR text matched.'}, 'has_more': {'type': 'boolean', 'description': 'Present when the API labelled the results: true when more results follow this page.'}, 'citations_combined': {'type': 'object', 'required': ['markdown', 'html', 'plain'], 'properties': {'html': {'type': 'string', 'description': 'Numbered attribution list as HTML.'}, 'plain': {'type': 'string', 'description': 'Numbered attribution list as plain text.'}, 'markdown': {'type': 'string', 'description': 'Numbered attribution list as Markdown.'}}, 'description': 'Combined attribution for all images in this response, in three formats.', 'additionalProperties': False}}, 'additionalProperties': True}
submit_image
Submit an image to the MemeStack review queue. Paid tool - 100 sats (or USDC equivalent) per submission via the agent payment rails (x402/L402); no account or API key. IMPORTANT: there is NO refund if moderation rejects the submission (duplicate, nsfw/spam, low quality) - the fee is the anti-spam mechanism. Accepted images await human review before publication. Accepts an HTTPS image URL or a data:image/...;base64 URL (JPEG/PNG/WebP, max 8MB). Optional caption/tags/attribution are hints shown to the AI tagger and moderators - never published verbatim. If the call fails or times out, retry with the SAME payment proof to resume - one payment delivers at most one submission and is never charged twice (up to 10 delivery attempts per payment; a corrected image_url is allowed while no submission has been created yet). Note for x402 clients: 100 sats exceeds the agents-SDK default per-call cap of $0.10 whenever BTC trades above $100k - raise maxPaymentValue in withX402Client if payment is refused client-side.
外部アクセスあり
入力スキーマ
{'type': 'object', 'required': ['image_url'], 'properties': {'tags': {'type': 'array', 'items': {'type': 'string', 'maxLength': 40}, 'maxItems': 10, 'description': 'Optional tag hints (max 10).'}, 'caption': {'type': 'string', 'maxLength': 200, 'description': 'Optional caption hint for the AI tagger (admin-visible, never published verbatim).'}, 'image_url': {'type': 'string', 'description': 'HTTPS image URL, or data:image/(jpeg|png|webp);base64,... URL. Max 8MB.'}, 'attribution': {'type': 'string', 'maxLength': 200, 'description': 'Optional credit line for the original creator/source (shown to moderators, not published).'}}}
出力スキーマ
{'type': 'object', 'required': ['image_id', 'status'], 'properties': {'status': {'type': 'string', 'description': "Always 'pending_review' on success — accepted, awaiting human moderation."}, 'image_id': {'type': 'string', 'description': 'UUID of the submitted image.'}, 'page_url': {'type': 'string', 'description': 'Gallery URL where the image will be published if approved.'}}, 'description': 'Outcome of a paid submit_image call: accepted into the human review queue.', 'additionalProperties': True}
tag_autocomplete
Suggest tag slugs matching a prefix. Use this to verify a tag exists before filtering by it, or to discover related tags. Prefix must be >= 2 characters.
読み取り専用
外部アクセスあり
冪等
入力スキーマ
{'type': 'object', 'required': ['prefix'], 'properties': {'limit': {'type': 'number', 'description': 'Max suggestions (1-50, default 10)'}, 'prefix': {'type': 'string', 'minLength': 2, 'description': 'Tag prefix to autocomplete (>= 2 characters), e.g. "bit" -> "bitcoin".'}}}
出力スキーマ
{'type': 'object', 'properties': {'tags': {'type': 'array', 'items': {'type': 'object', 'properties': {'tag': {'type': 'string', 'description': 'Tag slug.'}, 'name': {'type': 'string', 'description': 'Display name.'}, 'usage_count': {'type': 'number', 'description': 'Number of images using this tag.'}}, 'description': 'A tag with usage stats.', 'additionalProperties': True}, 'description': 'Suggested tags matching the prefix.'}}, 'description': 'Tag suggestions for a prefix.', 'additionalProperties': True}
履歴
最近のツール変更
変更
reverse_image_search
2026年10月1日2:51
変更
find_meme_for_text
2026年10月1日2:51
変更
search_text_in_image
2026年10月1日2:51
変更
get_mutation_group
2026年10月1日2:51
変更
browse_by_category
2026年10月1日2:51
変更
browse_by_tag
2026年10月1日2:51
変更
get_leaderboard
2026年10月1日2:51
変更
browse_images
2026年10月1日2:51
変更
find_related
2026年10月1日2:51
変更
find_similar
2026年10月1日2:51
変更
get_image
2026年10月1日2:51
変更
search_charts
2026年10月1日2:51
変更
search_images
2026年10月1日2:51
変更
reverse_image_search
2026年9月27日2:51
変更
cite_image
2026年9月27日2:51
変更
find_meme_for_text
2026年9月27日2:51
変更
search_text_in_image
2026年9月27日2:51
変更
get_mutation_group
2026年9月27日2:51
変更
browse_by_category
2026年9月27日2:51
変更
browse_by_tag
2026年9月27日2:51
変更
get_leaderboard
2026年9月27日2:51
変更
browse_images
2026年9月27日2:51
変更
find_related
2026年9月27日2:51
変更
find_similar
2026年9月27日2:51
変更
get_image
2026年9月27日2:51
変更
search_charts
2026年9月27日2:51
変更
search_images
2026年9月27日2:51
変更
generate_meme
2026年9月21日2:58
変更
submit_image
2026年9月21日2:58
変更
reverse_image_search
2026年9月21日2:58
関連MCP
類似のMCPサーバー
Social Fetch
io.github.social-freak-ltd/socialfetch
Retrieves public content and metadata from social networks, music services, Facebook Marketplace, events, profiles, posts, commen…
Heista
co.heista/api
Analyzes video advertising, builds brand intelligence profiles, researches markets, and generates advertising scripts and creativ…
VarynForge
com.varynforge/server
Supports SEO research and content planning through niche analysis, competitor and keyword research, opportunity discovery, and wr…
Tmdb
io.github.pipeworx-io/tmdb
Provides TMDB-based movie, television, and people discovery, metadata, credits, recommendations, videos, and trend-related entert…
AfterLaunch: the agentic growth marketing engine
io.afterlaunch/agentic-growth-marketing
Runs growth-marketing workflows covering SEO, AI-search visibility, competitor analysis, content planning, distribution channels,…
Setlist Fm
io.github.pipeworx-io/setlist-fm
Provides setlist.fm concert research by artist, venue, city, country, and date, including artist records, concert histories, and …
Watchmode
io.github.pipeworx-io/watchmode
Searches streaming catalogs and availability across regions, services, genres, networks, titles, and release dates.
Vimeo
io.github.pipeworx-io/vimeo
Searches and retrieves public Vimeo videos, channels, categories, and related metadata.