Music for your agent, no UI needed.
An AI agent can use Neume on its own. It signs up for an API key, pays for credits with an agent wallet, and makes songs and music videos through Neume's MCP server. There's no browser, sign-in page or checkout form at any step.
→ POST /v1/agents/signup201 { "apiKey": "neu_sk_…", "credits": 0 }→ POST /v1/agents/credits/5402 Payment Required · $4.99 · 10 credits→ POST /v1/agents/credits/5 Authorization: Payment …200 { "added": 10, "credits": 10 }→ tools/call generate_song{ "songIds": ["…"], "status": "starting" }→ tools/call make_video{ "videoId": "…", "seconds": 10, "credits": 11 }
How does an agent pay for Neume?
Neume accepts payments over MPP, the Machine Payments Protocol from Stripe and Tempo. When the agent asks to buy a credit pack, Neume answers with HTTP 402 Payment Required and the price. The agent pays and sends the same request again, and the credits are added to its account along with a receipt.
The agent pays with a card through a Link agent wallet. The wallet's owner decides how much the agent can spend without asking, so within that limit the agent pays on its own. Neume settles through Stripe like any other purchase.
What an agent can do with Neume.
The same engine and prices as the Neume app. Tools that only read are free.
Sign up with one call
POST to the sign-up endpoint and get an API key back. No email, password or browser.
Buy credits over HTTP 402
Pick a credit pack and pay with an agent wallet. The credits land the moment the payment clears.
Make a song
A full song with vocals from a title, a style and lyrics with part tags. No lyrics makes an instrumental.
Change one part
New words for a verse or chorus, sung again in the same voice. The original song is kept.
Reimagine a song
The whole song again in a new style, with its own words or new ones.
Make a music video
A scene you describe, set to part of a song, 4 to 30 seconds. A video that fails gives its credits back.
Three steps, all over HTTP.
Sign up, buy credits, then connect to the MCP server with the API key. Each step is one request.
1. Sign up
- 1POST to
/v1/agents/signup. The name is optional. - 2Keep the
apiKey(neu_sk_…). It's shown once. - 3The new account starts with 0 credits.
curl -X POST https://api.neume.io/v1/agents/signup \
-H "Content-Type: application/json" \
-d '{"name": "my-agent"}'2. Buy credits
- 1GET
/v1/agents/creditsfor the packs and their prices. - 2POST to
/v1/agents/credits/{productId}with the key inX-API-Key. The answer is 402 with the price. - 3Pay with a Link agent wallet and send the request again with
Authorization: Payment …. Link's CLI does both for you.
# One-time spend request in the Link agent wallet (amount in cents)
link-cli spend-request create \
--credential-type shared_payment_token \
--network-id profile_61Vf6kfEOu5n9kPtbA6Vf6kf6ySQSZlbgxdy025k0I0e \
--amount 499 \
--context "10 Neume credits so the agent can make a song for the user's project." \
--request-approval
# Pay for the pack and get the credits
link-cli mpp pay https://api.neume.io/v1/agents/credits/5 \
--spend-request-id lsrq_... \
--method POST \
--header "X-API-Key: neu_sk_..."Any MPP client works, such as mppx. Neume accepts cards through Link shared payment tokens. The Link agent wallet is available to US and Canadian Link accounts.
3. Make songs and videos
Streamable HTTP- 1Connect to Neume's MCP server with the API key as a Bearer token.
- 2Call
generate_song, then pollget_song_detailsuntil it's ready, usually in 30 to 120 seconds. - 3For a video, call
make_videowith one of its songs, then pollget_video_details. It takes a few minutes.
{
"mcpServers": {
"neume": {
"url": "https://api.neume.io/v1/mcp",
"headers": { "Authorization": "Bearer neu_sk_..." }
}
}
}Connecting an assistant for a person instead? They sign in with their Neume account: MCP setup for Claude, ChatGPT and others.
Every tool, and what it costs
On the MCP server at api.neume.io/v1/mcp. The agent names the tool it wants.
| Tool | What it does | Credits |
|---|---|---|
generate_song | Make a song from a title, a style and lyrics. No lyrics makes an instrumental. | 1 |
get_song_details | A song's status, title, cover, lyrics and audio link. | Free |
get_my_songs | The account's songs, newest first. | Free |
get_song_parts | A song's parts and the lines sung in each, with their times. | Free |
change_lyrics | New words for one part (5 to 30 seconds), sung again in the same voice. | 1 |
reimagine_song | The whole song again in a new style. | 2 |
make_video | A music video for one of its songs, from a description, 4 to 30 seconds. | Seconds + 1 (480p) |
get_video_details | A video's status, and its link once it's made. | Free |
get_balance | The account's credits. | Free |
list_topup_packages | The credit packs and their prices. | Free |
Tasks to give your agent
"Sign up for Neume, buy the 10-credit pack with my Link wallet, and make a 30-second upbeat jingle for my bakery."
"Make a birthday song for my sister Maya with Neume, then a 10-second music video of a dog party set to its chorus."
"Every Friday, make a short lo-fi track with Neume for my newsletter and send me the link."
"Make an acoustic version of my last Neume song and tell me how many credits are left."
Frequently asked
questions.
Can an AI agent sign up for Neume without a person?
Yes. A POST to https://api.neume.io/v1/agents/signup returns an account and an API key. There's no email, password or browser step.
How does the agent pay?
Over MPP, the Machine Payments Protocol. Buying a credit pack answers HTTP 402 with the price. The agent pays with a card through a Link agent wallet and sends the request again, and the credits are added. Payments settle through Stripe.
Does a person need to approve each payment?
Only if the wallet is set up that way. The owner of the Link agent wallet decides how much the agent can spend without asking. Within that limit, the agent pays on its own.
How much does it cost?
Credit packs start at $4.99 for 10 credits, and GET /v1/agents/credits lists them all. A song costs 1 credit, changing one part costs 1, reimagining a song costs 2, and a 480p music video costs 1 credit a second plus 1 (11 credits for 10 seconds).
Do agent accounts get free credits?
No. An agent account starts with 0 credits and buys what it needs.
Where do the songs and videos go?
They're saved to the agent's Neume account. get_my_songs lists its songs, and get_song_details and get_video_details return links to play or download them.
Can the songs be used commercially?
Original songs made with Neume belong to the account that made them, including for commercial use. Changing or remixing audio someone else made doesn't give rights to it.
Is there an agent skill or a description for LLMs?
Yes. The agent skill is at neume.io/.well-known/agent-skills/neume/SKILL.md (listed in /.well-known/agent-skills/index.json), and neume.io/llms.txt describes what Neume does, the agent steps and every tool.