Skip to content

feat(adapters): add Pixabay media MCP adapter - #1468

Merged
helpcodeai merged 6 commits into
HelpCode-ai:mainfrom
ak-bharadwaj:feat/adapter-pixabay
Nov 3, 2026
Merged

helpcodeai merged 6 commits into
HelpCode-ai:mainfrom
ak-bharadwaj:feat/adapter-pixabay

Conversation

@ak-bharadwaj

Copy link
Copy Markdown
Contributor

Summary

Adds a pre-built MCP adapter for Pixabay (packages/backend/src/adapters/intl/pixabay.json), exposing 2 read-only tools:

  • pixabay_search_images: Search royalty-free stock photos, illustrations, and vector graphics with rich filters (category, color, dimensions, image type, orientation, Editor's Choice, SafeSearch).
  • pixabay_search_videos: Search royalty-free stock video clips and animations with filters for type, category, dimensions, Editor's Choice, and SafeSearch.

Implementation Details

  • Authentication: QUERY_AUTH passing key: "{{PIXABAY_API_KEY}}".
  • Response Mapping: Added responseMapping transforms for both tools using transform.select and $from: "$.hits[*]" to shape responses cleanly and keep the useful fields (IDs, page URLs, dimensions, media format URLs, stats, and user profile data).
  • Tool Descriptions: Detailed descriptions exceeding 60 characters with clear guidance on inputs, filters, and returned structure.
  • Probe: Uses pixabay_search_images with { q: "nature", per_page: 3 }.
  • Icon: Added packages/frontend/public/logos/connectors/pixabay.svg.
  • Testing: Added static spec conformance and gated live test in packages/backend/src/adapters/intl/pixabay.live.spec.ts.
  • Catalog & Counts: Regenerated packages/backend/src/adapters/catalog.ts and updated adapter counts (693 -> 694); verified with node scripts/adapter-count.mjs --check and node scripts/validate-adapters.mjs.

Real Account / Testing

Built against the official Pixabay REST API documentation (https://pixabay.com/api/docs/) and verified via pixabay.live.spec.ts static assertions and catalog gate checks.

Closes #1409
Part of #982

Add pre-built MCP adapter for Pixabay royalty-free media platform:
- packages/backend/src/adapters/intl/pixabay.json: 2 read-only tools (pixabay_search_images and pixabay_search_videos) with QUERY_AUTH (key parameter), responseMapping transforms, and comprehensive filters.
- packages/frontend/public/logos/connectors/pixabay.svg: connector SVG icon.
- packages/backend/src/adapters/intl/pixabay.live.spec.ts: static spec conformance and gated live test.
- Regenerated catalog.ts and bumped adapter counts across docs (693 -> 694).

Closes HelpCode-ai#1409
# Conflicts:
#	README.ja.md
#	README.md
#	README.zh-CN.md

@helpcodeai helpcodeai left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @ak-bharadwaj. Fixed host, key as a query parameter, two read-only GET tools, live spec gated. I merged main into the branch to fix the count conflicts (695 adapters) and regenerated the catalog and llms files. Merging once CI is green on the updated branch.

@helpcodeai
helpcodeai merged commit b6ed672 into HelpCode-ai:main Nov 3, 2026
14 checks passed
@github-actions github-actions Bot locked and limited conversation to collaborators Nov 3, 2026
@helpcodeai

Copy link
Copy Markdown
Contributor

Merged, thanks @ak-bharadwaj. Main had moved again, so I merged it into your branch once more (counts now 695) before the merge.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Adapter: Pixabay

2 participants