setup

Setting up AINSOF

The AINSOF server is a remote, authless MCP endpoint: https://mcp.ainsof.io. Installing the plugin is normally all it takes: there is no OAuth flow, no account and no key required to start.

Verify the connection

Check that the AINSOF tools are present. The quickest confirmation is to call about_ainsof, which is read-only and returns catalog, licensing and privacy details. Fourteen tools should be available:

search_music · search_by_reference · find_soundtrack · find_similar · fit_to_length · get_track · listen_link · cue_sheet · analyze_video · score_my_video · get_upload_link · deliver_score · about_ainsof · feedback

If the tools are missing

Add the server directly:

claude mcp add --transport http ainsof https://mcp.ainsof.io

In other hosts:

• Claude.ai / Claude Desktop: Customize → Connectors → + Add → Add custom connector → https://mcp.ainsof.io (Free accounts can add one custom connector)
• Cursor: add to .cursor/mcp.json (project) or ~/.cursor/mcp.json (global):

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

• ChatGPT: add the official AINSOF app: https://chatgpt.com/plugins/plugin_asdk_app_6a78633c69008191bb4a9fac1a8e5b2e

Rate limits

Tier	Calls per day
No key	300
With an API key	1,000
More than that	email [email protected]

Keys are free. Sign in at https://ainsof.io/account/api-keys and choose Create new key (it is shown once), then send it as a bearer token:

claude mcp add --transport http ainsof https://mcp.ainsof.io \
  --header "Authorization: Bearer ain_…"

Three replies that are not errors

1. search_by_reference returning { ok: false, error: "still_running" }: the search is still running. Call it again with the same link.
2. find_soundtrack erroring without duration_sec: that is a missing argument, not an empty catalog. Supply the length, or use search_music.
3. analyze_video, score_my_video or deliver_score returning sign_in_required: before AINSOF works with a video, the person signs in once on ainsof.io with Google or email. Show them the returned link, then call again with the same arguments plus the sign_in_code.