How to Use the Genius MCP in Google ADK

Q: How can a Google ADK agent get all songs by an artist from Genius?

It uses the getartistsongs tool. The tool is paginated, so your agent can loop through the pages to collect a complete list of song titles and their Genius URLs for further processing.

Q: Does the Genius MCP Server support filtering tools for my Google ADK agent?

Yes, the Google ADK McpToolset constructor accepts a toolnames filter. You can explicitly list which of the seven Genius tools your agent is allowed to access.

Connect your Google ADK agents to the Genius lyrics database for large-scale analysis and long-context reasoning.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Genius MCP to Google ADK

Create your Vinkius account to connect Genius to Google ADK 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 Genius with Google ADK

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Query Genius from Your Google Cloud Agent

Your agent, running on a Gemini model, can now query the world's largest lyrics database. Start with `search_songs` to find tracks by title or artist. From there, use the song ID to feed data into your other systems. Pull full lyrics with `get_song` or an artist's entire catalog with `get_artist_songs` for analysis in BigQuery.

Analyze Lyric Meanings and Annotations

This isn't just about fetching text. Your agent can retrieve the community-sourced explanations behind the lyrics using `get_song_annotations`. It gets the annotated text fragment and the full explanation. For even more detail, use the annotation ID with `get_annotation` to get vote counts and author info. This gives your long-context agent rich, structured data to reason about a song's meaning.

Integrate Artist and Album Data with Google ADK

Build a complete picture of an artist or album. The `get_artist` tool provides profile info, images, and their Genius IQ score. The `get_album` tool gives you the tracklist, cover art, and release date. Because you're using Google ADK, you can easily pipe this structured metadata into other Google Cloud services. This MCP Server is the bridge between the music world and your enterprise data environment.

Setup guide

Set up Genius MCP in Google ADK

Prerequisites

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

1

Install Google ADK

Run pip install google-adk to install the Agent Development Kit. MCP support is included via the McpToolset class.
2

Connect via SSE transport

Use McpToolset.from_server() with SseServerParams pointing to your Vinkius endpoint. Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com.
3

Create an LlmAgent

Pass the returned mcp_tools list directly to LlmAgent(tools=mcp_tools). The ADK maps each MCP tool to a native Gemini function call — no manual schema definitions required.
4

Run with any Gemini model

The agent works with any Gemini model (gemini-2.0-flash, gemini-2.5-pro, etc.). Copy the full example on the right to get started with Genius tools in your ADK agent.

agent.py

from google.adk.agents import LlmAgent
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
from google.adk.tools.mcp_tool.mcp_session_manager import SseServerParams

# Connect to the MCP via SSE
mcp_tools, exit_stack = await McpToolset.from_server(
    connection_params=SseServerParams(
        url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    )
)

# Create your agent with auto-discovered tools
agent = LlmAgent(
    name="Genius_agent",
    model="gemini-2.0-flash",
    instruction="You have access to Genius tools via MCP.",
    tools=mcp_tools,
)

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 Genius. 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 Genius 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 Genius MCP in Google ADK

It uses the `get_artist_songs` tool. The tool is paginated, so your agent can loop through the pages to collect a complete list of song titles and their Genius URLs for further processing.

Yes, this MCP server works perfectly with Gemini. The structured tool outputs are designed to be easily understood by large models, making it a reliable data source for your Google ADK agents.

Yes, the Google ADK `McpToolset` constructor accepts a `tool_names` filter. You can explicitly list which of the seven Genius tools your agent is allowed to access.

It returns a rich object with the song's full title, artist, album, release date, producers, and full lyrics in both plain text and HTML formats.

All requests for artist profiles or song lyrics are stateless. The server acts as a secure proxy, and the Vinkius platform ensures your requests are processed in an isolated, zero-trust container that is torn down immediately after use. Your data isn't logged or stored.

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