Install Jentic One Beta
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the audiometa.io Web API, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Faudiometa.io%2Faudiometa" | shStep 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Faudiometa.io%2Faudiometa" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
What an agent can do with audiometa.io Web API.
Search across artists, albums, and tracks
Get an artist with stats, biography, genres, and country
Get an artist's albums, tracks, top tracks, and related artists
Get an album with its label, UPC, type, and release date
Get a track with its playcounts and audio features
GET STARTED
Browse tracks by musical key, tempo range, or record label
Patterns agents use audiometa.io Web API for, with concrete tasks.
★ Agent Music Metadata Lookup
An AI agent connected through Jentic searches the catalog for an artist or track and reads back structured metadata, so it can answer questions or enrich a record without scraping a music site. Because the response carries genres, playcounts, and audio features as fields, the agent acts on the data directly.
Search for an artist, then return their top tracks with each track's audio features
Playlist by Audio Features
A music app browses tracks within a tempo range and by musical key, then sorts the results, so it can assemble a set that fits a mood or mix without hand-picking songs. The by-tempo and by-key browse endpoints make feature-driven selection a single call each.
Return tracks between 120 and 128 BPM in a given key, sorted by popularity
Catalog Enrichment
A pipeline resolves a list of track or album ids to full records with labels, release dates, and playcounts, so another system can enrich its own music library. Unknown ids return a not-found response, which keeps the enrichment step predictable.
For each track id, fetch its album, label, and release date and attach them to the record
15 endpoints — the audiometa api serves music metadata for artists, albums, and tracks, with catalog search and enrichment such as social stats, playcounts, and audio features.
METHOD
PATH
DESCRIPTION
/v1/search
Search the catalog
/v1/artists/{id}
Get an artist
/v1/artists/{id}/top-tracks
Get an artist's top tracks
/v1/albums/{id}
Get an album
/v1/tracks/by-tempo
Get tracks by BPM range
/v1/tracks/{id}
Get a track
/v1/search
Search the catalog
/v1/artists/{id}
Get an artist
/v1/artists/{id}/top-tracks
Get an artist's top tracks
/v1/albums/{id}
Get an album
/v1/tracks/by-tempo
Get tracks by BPM range
/v1/tracks/{id}
Get a track
What agents get from Jentic-routed access to this vendor.
Setup
Wiring the Audiometa API by hand means creating a key, deciding whether to send it as a bearer token or an x-api-key header, and handling the offset and limit paging on every list. Through Jentic you install once, import Audiometa from the API Directory, store the key once, and your agent calls it.
Permission scoping
You choose which operations your agent may call, so you can allow catalog search and reading artist, album, and track records and leave anything else out. Audiometa carries the search query and ids in the request and path, so your rules bound which read operations run, and every call the agent makes is logged.
Credential isolation
Your Audiometa key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context.
Intent-based discovery
Agents search Jentic by intent such as 'search for an artist' or 'get a track's audio features', and Jentic returns the matching Audiometa operation with its input schema so the agent calls the right endpoint without reading the reference docs.
Alternatives and complements available in the Jentic catalogue.
Specific to using audiometa.io Web API through Jentic.
Is there an Audiometa MCP server?
You don't need an MCP server to give your agent the Audiometa API. Jentic connects it directly from the API Directory: import it, store your key once, and your agent can search the catalog and read track metadata straight away, with no extra server to run and no tool definitions to load into the agent's context.
Can I limit what my agent is allowed to do with the Audiometa API?
Yes. Write a rule that allows the search and read operations the agent needs, such as searching the catalog and fetching artist and track records, and nothing else, and every call it makes is logged. The whole API is read-only, so no rule gives the agent any way to change your data.
What authentication does the Audiometa API use?
The Audiometa API authenticates with a bearer token (an amsk_ key), and it also accepts the same key in an x-api-key header, per its OpenAPI spec. Through Jentic the key is stored encrypted by your own instance and added at call time, so it never appears in the agent's prompt or logs.
Can I find songs by tempo or musical key with the Audiometa API?
Yes. The by-tempo browse endpoint takes a tempo range and the by-key endpoint takes a musical key, both with sorting and paging, so an agent can assemble a feature-matched set of tracks. Each track also carries its audio features for further filtering on your side.
What are the rate limits for the Audiometa API?
Each API key is limited to 100 requests per minute according to the API's own description, enforced per key rather than per account. For current limits, see the Audiometa documentation at https://audiometa.io/dashboard/api.
How do I look up music metadata with the Audiometa API through Jentic?
Import the Audiometa API from the Jentic API Directory, then have your agent issue a request such as 'search for this artist and return their top tracks'. Jentic matches the intent to the search and artist operations and returns their input schemas so the agent builds the right calls, with your stored key injected at call time. To run it on your own infrastructure, install Jentic One from its GitHub repo.
For Agents
Search music metadata for artists, albums, and tracks, and read enrichment such as genres, playcounts, and audio features. Authenticates with a bearer token or an x-api-key header.
Use for: Search for an artist by name, Get an artist's top tracks, Find related artists for a given artist, List an album's tracks
Not supported: Does not stream audio, host files, or sell music. Use for looking up music catalog metadata and audio features only.
The Audiometa API serves music metadata for artists, albums, and tracks, with catalog search and enrichment such as social stats, playcounts, and audio features. You can search across artists, albums, and tracks, fetch an artist with biography, genres, and country, pull an album with its label, UPC, type, and release date, and read a track with its playcounts and audio features. Tracks can also be browsed by musical key, by a tempo range, or by record label, with sorting and paging.
This API is usable in Jentic One now. Its AI-readiness score against Jentic's framework shows where it stands today and where improvements would make it even easier for agents to use.
Base layer of spec validity and structural soundness.
Aggregated quality score from linter diagnostics, weighted by severity.
Percentage of `$ref` references that resolve successfully.
Checks whether the API description parses successfully and conforms to its declared specification (e.g., OpenAPI).
Structural correctness score based on schema issues using logarithmic dampening.
Clarity, completeness, and ingestion readiness for developers and tooling.
How richly the API is illustrated with examples.
Percentage of examples that conform to their schemas.
Percentage of operations with complete response definitions (success, client error, server error).
Health of API ingestion, bundling, and resolution within Jentic pipelines.
Semantic breadth, depth, and agent comprehension for AI systems.
Coverage of descriptions across API elements.
Coverage of RFC 9457 Problem Details for error responses.
Coverage, uniqueness, and casing consistency of operationIds for AI inference.
Coverage of summaries across operations/tags/info.
Functional utility, complexity comfort, and AI orchestration readiness.
Agent comfort level based on API operational and structural complexity.
Trust, risk posture, and security compliance.
Average quality of security schemes based on authentication method strength (weakest link for OAuth2).
Findability, semantic richness, and reasoning readiness.
Clarity and depth of descriptions across API elements.
Score it yourself
Every API in the directory is allowlisted, so you can re-score it with no key required.
npx @jentic/api-scorecard-cli score <openapi-url>