How to Use the Getty Images MCP in CrewAI

Q: How do I add the Getty Images MCP Server to a CrewAI agent?

Add the HTTP endpoint URL directly to the mcps list in your agent definition. This gives that specific agent immediate access to all search and retrieval tools.

Q: Can I limit which Getty Images tools a CrewAI agent can access?

Yes. Use MCPServerHTTP from the crewai.mcp module and apply a toolfilter to expose only search tools while hiding the download tools from researchers.

Q: Does CrewAI support batch queries for Getty Images stock photos?

Yes. Your agents can use getimagesbatch to fetch details for multiple assets at once, which speeds up collaborative curation tasks.

Deploy specialized CrewAI agent teams to research, curate, and license assets using the Getty Images MCP Server.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Getty Images MCP to CrewAI

Create your Vinkius account to connect Getty Images to CrewAI and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Getty Images with CrewAI

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Coordinate multi-agent creative research with CrewAI

`search_images` lets your researcher agent find stock photos based on complex design briefs. Once the researcher finds candidate assets, it hands the IDs over to an editor agent for closer inspection. The editor agent then calls `get_similar` to find alternative options that match the visual style of your campaign. This collaborative process runs entirely in the background without needing human guidance.

Enforce license compliance across your entire team

`search_editorial` restricts search results to news and editorial photos that cannot be used in commercial ads. Your compliance agent monitors the session and blocks these assets from entering commercial campaigns. For marketing tasks, the compliance agent forces the team to use `search_creative` instead. This structural boundary protects your company from legal liabilities and copyright claims.

Automate asset collection building via MCP Server tools

`list_collections` lets your lead agent inspect your current lightboxes and organize them by project. The agent can categorize hundreds of assets into distinct folders based on metadata. If a team member requests video content, the agent invokes `search_videos` and `get_video` to populate the same collection. This keeps all your media assets organized in one place automatically.

Setup guide

Set up Getty Images MCP in CrewAI

Prerequisites

Python 3.10+ installed
crewai package (pip install crewai)
Active Vinkius subscription with a valid endpoint token

1

Install CrewAI
Run pip install crewai to install the framework. MCP support is built-in via the mcps parameter.
2

Add the MCP URL to your agent
Pass your Vinkius endpoint directly to the mcps list. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. CrewAI handles tool discovery and caching automatically.
3

Kick off your crew
Create a Crew with your agent and tasks. Call crew.kickoff() — the agent will automatically invoke Getty Images tools as needed.

crew.py

from crewai import Agent, Task, Crew

agent = Agent(
    role="Getty Images Analyst",
    goal="Access and analyze Getty Images data via MCP.",
    backstory="Expert analyst with direct Getty Images access.",
    mcps=[
        "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    ],
)

task = Task(
    description="List recent Getty Images transactions",
    agent=agent,
    expected_output="A summary of recent activity",
)

crew = Crew(agents=[agent], tasks=[task])
result = crew.kickoff()
print(result)

Get your connection token →

Prerequisites

Python 3.10+ installed
crewai + crewai-tools packages
Active Vinkius subscription with a valid endpoint token

1

Install dependencies
Run pip install crewai crewai-tools. The MCPServerAdapter handles lifecycle management and tool conversion.
2

Connect with MCPServerAdapter
Use MCPServerAdapter as a context manager with SseServerParameters pointing to your Vinkius endpoint. The adapter automatically manages connection lifecycle.
3

Assign tools and run
Pass the returned mcp_tools to your agent's tools parameter. The adapter converts MCP tools to native BaseTool objects compatible with all CrewAI agents.

crew.py

from crewai import Agent, Task, Crew
from crewai_tools import MCPServerAdapter
from mcp import SseServerParameters

server_params = SseServerParameters(
    url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
)

with MCPServerAdapter(server_params) as mcp_tools:
    agent = Agent(
        role="Getty Images Analyst",
        goal="Access and analyze Getty Images data via MCP.",
        backstory="Expert analyst with direct Getty Images access.",
        tools=mcp_tools,
    )

    task = Task(
        description="List recent Getty Images transactions",
        agent=agent,
        expected_output="A summary of recent activity",
    )

    crew = Crew(agents=[agent], tasks=[task])
    result = crew.kickoff()
    print(result)

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Getty Images. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Getty Images now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Getty Images MCP in CrewAI

Add the HTTP endpoint URL directly to the `mcps` list in your agent definition. This gives that specific agent immediate access to all search and retrieval tools.

Yes. Use `MCPServerHTTP` from the `crewai.mcp` module and apply a `tool_filter` to expose only search tools while hiding the download tools from researchers.

Agents pass asset IDs and preview URLs through the shared memory system. A research agent can find an image ID, and a writer agent can use `get_image` to read its caption.

Yes. Your agents can use `get_images_batch` to fetch details for multiple assets at once, which speeds up collaborative curation tasks.

The server only sends your search phrases, asset IDs, and video queries to the Getty API. It does not transmit your crew configurations, agent prompts, or internal team discussions.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript