Back to home

MCP Server for Rap Names and Lyrics

Connect an AI assistant to rap name and lyric tools. Explore parameters, responses, examples, and free usage.

Last updated: 2026-11-10

Connect an MCP-compatible assistant to rap name and lyric tools over Streamable HTTP. Generate names for free and try lyric writing with 10 free drafts.

Connect your assistant

  1. Sign in and create a key at Settings → API Keys.
  2. Add a remote MCP server with the URL https://airapgenerators.com/api/mcp.
  3. Set the HTTP header Authorization: Bearer YOUR_API_KEY. Keep the key private.

For clients that accept a JSON connection configuration:

{
  "url": "https://airapgenerators.com/api/mcp",
  "headers": {
    "Authorization": "Bearer YOUR_API_KEY"
  }
}

Configuration formats vary by client. Use a client that supports remote Streamable HTTP servers and an authorization header. Tool calls require a valid account API key.

Make a request

MCP clients initialize the connection, discover tools with tools/list, and call them with tools/call. The endpoint accepts JSON-RPC requests by HTTP POST. Send Content-Type: application/json and Accept: application/json, text/event-stream.

For example, after initialization, call the name generator from a terminal. Replace the placeholder with your own key:

curl https://airapgenerators.com/api/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -H 'Authorization: Bearer YOUR_API_KEY' \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "generate_rap_names",
      "arguments": { "style": "melodic", "count": 2 }
    }
  }'

A successful response has a JSON-RPC result. Its structuredContent contains the tool's fields, and content[0].text contains the same object serialized as JSON:

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"names\":[\"Silver Echo\",\"Midnight Sky\"],\"style\":\"melodic\",\"form\":\"mixed\"}"
      }
    ],
    "structuredContent": {
      "names": ["Silver Echo", "Midnight Sky"],
      "style": "melodic",
      "form": "mixed"
    }
  }
}

The examples below show the arguments to pass to tools/call and the corresponding structuredContent. Names and lyrics are illustrative; actual results vary. Arguments are case-sensitive, and unlisted fields are rejected.

generate_rap_names

Create up to 12 rap name ideas. All arguments are optional.

  • style — string; one of trap, drill, boom-bap, melodic, luxury, underground, west-coast, or futuristic. Default: trap.
  • form — string; one of mixed, two-words, one-word, prefix, mc-dj, initials, da-the, or concept. Default: mixed.
  • mustInclude — string, at most 12 characters. The generator keeps English letters and spaces and adds the cleaned text to each name.
  • noNumbers — boolean. Default: true.
  • count — integer from 1 to 12. Default: 12. Fewer names may be returned when the selected form has a small pool.

Example arguments:

{
  "style": "melodic",
  "form": "two-words",
  "mustInclude": "Nova",
  "count": 2
}

Example structuredContent:

{
  "names": ["Nova Silver Echo", "Nova Midnight Sky"],
  "style": "melodic",
  "form": "two-words"
}

generate_wu_tang_name

Create a Wu-Tang-inspired name and a short interpretation.

  • name — required string, up to 48 characters; must contain usable letters or numbers.
  • style — classic or street. Default: classic.

Example arguments:

{ "name": "Maya", "style": "classic" }

Example structuredContent:

{
  "name": "Hidden Mantis the Wise",
  "style": "classic",
  "interpretation": "You notice the opening other people miss. The mantis suggests fast hands and close attention."
}

The same cleaned name and style produce the same result.

generate_rap_lyrics

Draft a short original English rap verse from a topic and style. This tool returns text, not audio or video.

  • topic — required nonempty string, up to 300 characters.
  • style — optional string using the same eight styles as generate_rap_names. Default: trap.

Example arguments:

{ "topic": "friends celebrating a road trip", "style": "boom-bap" }

Example structuredContent:

{
  "lyrics": "Windows down, we ride beneath the summer sky\nOld friends, new roads, let the miles roll by\nSnacks in the back and a map on the seat\nLaughing to the rhythm of the tires and beat\nSunset in the mirror, good times up ahead\nSinging every chorus, every word we said\nHands to the horizon, let the whole world see\nNothing like a road trip with my friends and me",
  "style": "boom-bap",
  "remaining": 9,
  "resetsAt": "2026-11-11T08:00:00.000Z"
}

lyrics is the generated text, remaining is the number of free lyric drafts left in the current allowance, and resetsAt is the UTC reset time in ISO 8601 format. Lyric generation can take up to a minute.

generate_birthday_rap_lyrics

Draft an English birthday verse using a person's name and a detail about them.

  • name — required nonempty string, up to 40 characters.
  • detail — required nonempty string, up to 200 characters.
  • relationship — required string: best-friend, couple, family, coworker, or kid-friendly.

Example arguments:

{
  "name": "Maya",
  "detail": "loves hiking and birthday cake",
  "relationship": "best-friend"
}

Example structuredContent:

{
  "kind": "success",
  "lines": [
    "Maya hits the trail with the morning sun",
    "Lacing up her boots for another run",
    "Birthday cake is waiting at the end today",
    "Friends are bringing cheers all along the way",
    "Every mountain view is a reason to smile",
    "Good times keep rolling for another mile",
    "Happy birthday Maya let the whole room cheer",
    "Happy birthday Maya here's to a bright new year"
  ],
  "lyrics": "Maya hits the trail with the morning sun\nLacing up her boots for another run\nBirthday cake is waiting at the end today\nFriends are bringing cheers all along the way\nEvery mountain view is a reason to smile\nGood times keep rolling for another mile\nHappy birthday Maya let the whole room cheer\nHappy birthday Maya here's to a bright new year",
  "remaining": 8,
  "resetsAt": "2026-11-11T08:00:00.000Z"
}

lines contains the verse line by line; lyrics joins those lines with newlines. If the birthday input is blocked, kind is blocked, a reason is included (public-figure, harmful-detail, or minor), and the tool returns a neutral fallback verse. A blocked request still uses one draft.

Free usage and errors

The two name tools are free. The two lyric tools share 10 free drafts per account per 24-hour period, starting with the first lyric request. A failed generation returns its draft; video creation on the website uses the applicable video credits. Allowance counters currently run in server memory and may reset on a restart or differ between server instances.

An invalid or missing API key returns HTTP 401 with a JSON-RPC error. Invalid tool arguments, an exhausted lyric allowance, and provider failures return an MCP tool result with isError: true. For example:

{
  "jsonrpc": "2.0",
  "id": 2,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"error\":\"The lyric generator is temporarily unavailable. Your free draft was returned; please try again.\"}"
      }
    ],
    "isError": true
  }
}

When the allowance is exhausted, the error text includes the reset time. For connection help, email support@airapgenerators.com.