Back to home

Connect AI Rap Generators to Claude via MCP

Set up the AI Rap Generators remote MCP server in Claude Desktop or Claude Code with a private account API key.

Last updated: 2026-11-12

Connect Claude to the AI Rap Generators remote MCP server to create rap names, lyric drafts, and original duo video tasks from a conversation. The server uses Streamable HTTP at https://airapgenerators.com/api/mcp. Tool calls need an AI Rap Generators account API key in the Authorization Bearer header. Video tasks require two public HTTPS image URLs and 10 account credits; the MCP tools cannot upload private files.

The server exposes four text tools and four video tools: create_rap_video, get_video_status, get_credits, and list_rap_stages for video tasks. Check credits before creating; a free first video is not guaranteed. Name tools are free, and the general and birthday lyric tools share 10 free drafts per account per 24-hour period. For fields, limits, sample responses, and errors, see the MCP reference or API reference.

Create an API key

Sign in to AI Rap Generators and open Settings → API Keys. Create a key with a name such as “Claude MCP”. Copy the full value when it appears; the dashboard does not show the complete key again. Keep it private and do not paste it into a public project file or chat. If a key is exposed, delete it from the same settings page and create another.

Claude Desktop

Claude Desktop connects to remote MCP servers through the Connectors interface. Open Customize → Connectors, choose Add custom connector, enter a name such as “AI Rap Generators”, and paste https://airapgenerators.com/api/mcp as the server URL. Continue to authentication settings. Choose fixed request headers and add the header name Authorization with the value Bearer YOUR_API_KEY, replacing the placeholder with your own key. Save the connector and enable it for the conversation. Team or Enterprise workspaces may require an organization owner to add the connector before individual members can connect.

Claude Desktop’s connector settings store the credential for the connector. Do not put the key in a prompt. The exact labels can change as Anthropic updates its interface; use the connector’s request-header setting because this server expects a static Bearer key rather than an OAuth sign-in flow.

Claude Code

Set the key in the shell environment, then register the remote HTTP endpoint. This keeps the key out of the command history:

export AIRAP_API_KEY="YOUR_API_KEY"
claude mcp add --transport http --scope user airap \
  https://airapgenerators.com/api/mcp \
  --header "Authorization: Bearer $AIRAP_API_KEY"
claude mcp list

The user scope makes the server available across Claude Code projects. To limit it to one project, use Claude Code’s project scope instead. Check that the airap server appears as connected with claude mcp list, then run /mcp in Claude Code to inspect the tools. If Claude Code cannot see the variable, start it from a shell that has AIRAP_API_KEY set.

Try a request

Ask Claude: “Draft an eight-line boom-bap verse about friends celebrating a road trip.” For a birthday, provide the person’s name, one personal detail, and one supported relationship. Ask for a rap name by specifying a broad style or name form. The lyric tool may take up to a minute; if it returns an unavailable-provider message, the unused draft is returned.

If a tool call returns HTTP 401, check the API key and confirm the exact header format: Authorization: Bearer YOUR_API_KEY. Invalid tool arguments and exhausted lyric allowance are returned as readable MCP tool errors. An assistant can then use the returned reset time or ask you to revise the request.

What Claude can and cannot do here

Claude can create an original duo video task with create_rap_video and check it with get_video_status. Provide two image URLs that the video provider can access and use only authorized images; adults shown must have consented. For private photo uploads, use the AI Rap Generators website. The get_credits tool reports the balance and the list_rap_stages tool lists stage options. Poll no more than once every three seconds. A lyric draft can help prepare the idea, but the generated video may adapt it. For connection and request details, see MCP setup, API behavior, Cursor instructions, Codex instructions, and the AI Rap Video Skill.

Official client references