`search`

Pack: genius · Connect: https://pipeworx.io/mcp (see Connect below for a single-pack URL)

No MCP client? Call it directly: GET https://gateway.pipeworx.io/v1/tools/search for the schema, then POST the same URL with its arguments for the data.

Search Genius for songs by title, artist, or keyword. Returns song METADATA hits (id, title, artist, Genius URL, release date, pageviews) — NOT lyric text (the Genius API does not return lyrics). Example: search({ query: “kendrick lamar humble”, limit: 10 })

Parameters

Name	Type	Required	Description
`query`	string	yes	Search term — song title, artist name, or keyword, e.g. “humble kendrick”
`limit`	number	no	Max number of results to return (default 10)
`_apiKey`	string	no	Genius access token (optional — omit to use the platform key; get your own free at https://genius.com/api-clients)

Example call

Arguments

{
  "query": "humble kendrick lamar",
  "limit": 10
}

curl

curl -X POST https://gateway.pipeworx.io/genius/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search","arguments":{"query":"humble kendrick lamar","limit":10}}}'

TypeScript (@pipeworx/sdk)

import { Pipeworx } from '@pipeworx/sdk';
const pipeworx = new Pipeworx();

const result = await pipeworx.call('search', {
  "query": "humble kendrick lamar",
  "limit": 10
});

More examples

{
  "query": "blinding lights the weeknd"
}

Connect

Add this to your MCP client config — every tool in the catalog, including this one — or use one-click install buttons:

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://pipeworx.io/mcp"
    }
  }
}

Connect to just the genius pack

{
  "mcpServers": {
    "genius": {
      "url": "https://gateway.pipeworx.io/genius/mcp"
    }
  }
}

See Getting Started for client-specific install steps.

search