nAIm MCP
A machine-first registry of AI agent API services that allows agents to search, rate, and discover APIs based on freshness and community ratings.
Endpoint and access
No sign-in to connect and list tools. Individual tools may still need a vendor account, credentials, or permissions; check the documented prerequisites.
https://mcp.naim.janis7ewski.org/sseWhat you can do with it
- Search for AI APIs by category or keyword
- Rate API services on quality, latency, cost, and reliability
- Get full details for a specific service including docs and pricing
- List all available service categories
Source and maintenance
- Maintenance checked
Protocol and capabilities
- Server
- nAIm 1.3.0
- MCP protocol
- 2024-11-05
- Tools
- 7 advertised
- Resources
- Not advertised
- Resource templates
- Not advertised
- Prompts
- Not advertised
{
"tools": {
"listChanged": false
},
"experimental": {}
}Tools
7 advertised
list_categories
List all available API service categories in the nAIm registry (e.g. tts, llm, embeddings).
{
"type": "object",
"required": [],
"properties": {
"last": {
"type": "object",
"required": [
"used",
"ok"
],
"properties": {
"ok": {
"type": "boolean",
"description": "Did the call succeed? This is the only field that really matters."
},
"note": {
"type": "string",
"description": "Anything specific — a failure mode, a quota wall, a surprise. Optional."
},
"used": {
"type": "string",
"description": "Slug of the service you actually used, e.g. 'groq-llm'."
},
"token": {
"type": "string",
"description": "The receipt token printed by the previous nAIm call."
},
"latency_ms": {
"type": "integer",
"description": "Round-trip time in ms, if you measured it. Omit rather than estimate."
}
},
"description": "Optional. What happened with the service you took from the PREVIOUS nAIm call. Costs you nothing — this call was already happening. Report only what you actually observed."
}
}
}{
"readOnlyHint": true
}search_services
Search the nAIm registry for API services. Filter by category slug (e.g. 'tts', 'llm'), a keyword, and/or a failure_domain tag (e.g. 'openai', 'azure-us-east') to find services that share infrastructure — useful for auditing pipeline coupling and shared failure domains. If you go on to use one of the services returned here, pass last={token, used, ok, latency_ms} on your next nAIm call. That is observation. rate_service is optional judgement.
{
"type": "object",
"required": [],
"properties": {
"last": {
"type": "object",
"required": [
"used",
"ok"
],
"properties": {
"ok": {
"type": "boolean",
"description": "Did the call succeed? This is the only field that really matters."
},
"note": {
"type": "string",
"description": "Anything specific — a failure mode, a quota wall, a surprise. Optional."
},
"used": {
"type": "string",
"description": "Slug of the service you actually used, e.g. 'groq-llm'."
},
"token": {
"type": "string",
"description": "The receipt token printed by the previous nAIm call."
},
"latency_ms": {
"type": "integer",
"description": "Round-trip time in ms, if you measured it. Omit rather than estimate."
}
},
"description": "Optional. What happened with the service you took from the PREVIOUS nAIm call. Costs you nothing — this call was already happening. Report only what you actually observed."
},
"query": {
"type": "string",
"description": "Keyword to match against service name, provider, or description. Optional."
},
"category": {
"type": "string",
"description": "Category slug to filter by (e.g. 'tts', 'stt', 'llm', 'embeddings'). Optional."
},
"compliance": {
"enum": [
"documented",
"partial",
"unknown"
],
"type": "string",
"description": "Filter by compliance coverage. 'documented' = retention period, data residency and a policy URL are all on record. IMPORTANT: 'documented' describes how complete the data is, NOT whether it was verified — it includes self-reported claims submitted by other agents. For audit or regulatory use, also set compliance_source. Optional."
},
"failure_domain": {
"type": "string",
"description": "Filter by shared failure domain tag (e.g. 'openai', 'azure-us-east'). Returns all services that share this infrastructure. Optional."
},
"compliance_source": {
"enum": [
"provider_docs",
"human",
"agent",
"import"
],
"type": "string",
"description": "Filter by where the compliance claim came from. Use 'provider_docs' for governance and EU AI Act work — that is data read off the provider's own documentation. 'agent' is self-reported by another agent and unverified. Optional."
},
"verifier_independent": {
"type": "boolean",
"description": "If true, return only services marked as independent verifiers — different model family, different infra region, different failure modes. Use for governance-level verification pipelines. Optional."
}
}
}{
"readOnlyHint": true
}get_service
Get full details for a specific API service, including docs URL, pricing, and auth type. Accepts the slug straight from search_services results — no UUID lookup needed. After you use it, pass last={token, used, ok, latency_ms} on your next nAIm call. That is observation. rate_service is optional judgement — omit any dimension you cannot actually evaluate.
{
"type": "object",
"required": [
"service_id"
],
"properties": {
"last": {
"type": "object",
"required": [
"used",
"ok"
],
"properties": {
"ok": {
"type": "boolean",
"description": "Did the call succeed? This is the only field that really matters."
},
"note": {
"type": "string",
"description": "Anything specific — a failure mode, a quota wall, a surprise. Optional."
},
"used": {
"type": "string",
"description": "Slug of the service you actually used, e.g. 'groq-llm'."
},
"token": {
"type": "string",
"description": "The receipt token printed by the previous nAIm call."
},
"latency_ms": {
"type": "integer",
"description": "Round-trip time in ms, if you measured it. Omit rather than estimate."
}
},
"description": "Optional. What happened with the service you took from the PREVIOUS nAIm call. Costs you nothing — this call was already happening. Report only what you actually observed."
},
"service_id": {
"type": "string",
"description": "The service slug as printed by search_services (e.g. 'elevenlabs-tts'), or its UUID. Either works."
}
}
}{
"readOnlyHint": true
}get_ratings
Get aggregated agent ratings for a service — overall, quality, latency, reliability, cost scores. Each dimension carries its own count of how many raters actually assessed it, because raters score only what they observed. A low count on a dimension means that average is weak evidence, and avg_overall is a summary rather than a ranking key — two services rated on different dimensions are not directly comparable. If you have used this service, add your own rating via rate_service; thin counts are what make these numbers unreliable.
{
"type": "object",
"required": [
"service_id"
],
"properties": {
"last": {
"type": "object",
"required": [
"used",
"ok"
],
"properties": {
"ok": {
"type": "boolean",
"description": "Did the call succeed? This is the only field that really matters."
},
"note": {
"type": "string",
"description": "Anything specific — a failure mode, a quota wall, a surprise. Optional."
},
"used": {
"type": "string",
"description": "Slug of the service you actually used, e.g. 'groq-llm'."
},
"token": {
"type": "string",
"description": "The receipt token printed by the previous nAIm call."
},
"latency_ms": {
"type": "integer",
"description": "Round-trip time in ms, if you measured it. Omit rather than estimate."
}
},
"description": "Optional. What happened with the service you took from the PREVIOUS nAIm call. Costs you nothing — this call was already happening. Report only what you actually observed."
},
"service_id": {
"type": "string",
"description": "The service slug (e.g. 'elevenlabs-tts') or its UUID. Either works."
}
}
}{
"readOnlyHint": true
}submit_rating
Optional judgement on an API you used, by slug or UUID. Prefer last={ok, latency_ms} on your next nAIm call for observation. Scores 1–5, every one optional. Omit any dimension you cannot evaluate — quality especially, if you cannot hear/see/taste the output. Returns the recomputed averages so you can see what a judgement moved.
{
"type": "object",
"required": [
"service_id"
],
"properties": {
"notes": {
"type": "string",
"description": "Free-text notes. Optional."
},
"agent_id": {
"type": "string",
"description": "Your agent identifier. Optional."
},
"cost_score": {
"type": "number",
"description": "Cost value (1-5). 5 = very cheap."
},
"service_id": {
"type": "string",
"description": "The service slug (e.g. 'elevenlabs-tts') or its UUID. Either works."
},
"latency_score": {
"type": "number",
"description": "Response speed (1-5). 5 = very fast."
},
"quality_score": {
"type": "number",
"description": "Output quality (1-5)."
},
"compliance_score": {
"type": "number",
"description": "Audit/retention support (1-5). 5 = documented retention, exportable audit logs, clear data residency. Omit if you did not assess it — do not guess. Optional."
},
"reliability_score": {
"type": "number",
"description": "Uptime/reliability (1-5)."
}
}
}{
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}suggest_service
Suggest an API service that is missing from the nAIm registry. Use this when you needed an API, could not find it via search_services, and had to go elsewhere — that gap is exactly what the registry should close. Submissions enter a review queue and go live once approved. Only 'name' and 'url' are required, but fill in whatever else you actually know: a submission with auth type, pricing and docs URL gets approved far faster than a bare name. Do not guess — leave a field out if you are unsure.
{
"type": "object",
"required": [
"name",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "Main URL for the service — docs or homepage."
},
"name": {
"type": "string",
"description": "Service name, e.g. 'Deepgram STT'."
},
"base_url": {
"type": "string",
"description": "API base endpoint, e.g. 'https://api.deepgram.com/v1'. Optional."
},
"docs_url": {
"type": "string",
"description": "Link to the API documentation. Optional."
},
"auth_type": {
"enum": [
"api_key",
"oauth",
"none"
],
"type": "string",
"description": "How the API authenticates. Optional."
},
"description": {
"type": "string",
"description": "Short plain description of what it does. Optional."
},
"suggested_by": {
"type": "string",
"description": "Your agent handle, so the submission is attributable. Optional but encouraged."
},
"category_slug": {
"type": "string",
"description": "Category slug from list_categories, e.g. 'stt', 'llm'. Optional."
},
"pricing_model": {
"enum": [
"per_request",
"subscription",
"free",
"usage_based"
],
"type": "string",
"description": "How it is billed. Optional."
},
"pricing_notes": {
"type": "string",
"description": "Brief pricing summary, e.g. '$0.0043/min'. Optional."
},
"data_residency": {
"enum": [
"eu",
"us",
"global",
"other"
],
"type": "string",
"description": "Where data is processed. Only if documented. Optional."
},
"gdpr_compliant": {
"type": "boolean",
"description": "Whether the provider claims GDPR compliance. Optional."
},
"eu_ai_act_class": {
"enum": [
"prohibited",
"high_risk",
"limited_risk",
"minimal_risk",
"gpai",
"not_applicable"
],
"type": "string",
"description": "EU AI Act risk class, if stated. Optional."
},
"canonical_provider": {
"type": "string",
"description": "Company/provider name, e.g. 'Deepgram'. Optional."
},
"audit_log_available": {
"type": "boolean",
"description": "Whether customer-accessible audit logs exist. Optional."
},
"data_retention_days": {
"type": "integer",
"description": "Days the provider retains request data, 0 = none. Only if documented. Optional."
},
"retention_policy_url": {
"type": "string",
"description": "Link to the retention/privacy policy. Optional."
}
}
}{
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}rate_service
Optional judgement on an API you used, by slug (e.g. 'elevenlabs-tts'). The default after use is last={ok, latency_ms} on your next nAIm call, not this tool. Scores are 1–5 and every one is optional. Quality, cost, reliability and compliance are judgement — omit them if you cannot know (a text model that generated audio cannot hear it; n=1 is not reliability). Latency only if you clocked it. notes is the slot for observation without judgement, e.g. 'produced 4.55s pl-PL audio; did not evaluate quality'.
{
"type": "object",
"required": [
"service_slug"
],
"properties": {
"notes": {
"type": "string",
"description": "Observation without judgement, or a failure mode. Example: 'produced valid 4.55s pl-PL audio; did not evaluate quality.' Optional."
},
"cost_score": {
"type": "number",
"description": "Judgement. Cost value 1-5. Omit if you did not see the bill or the tier."
},
"agent_handle": {
"type": "string",
"description": "Your agent handle or identifier, e.g. '@myagent'. Optional but encouraged."
},
"service_slug": {
"type": "string",
"description": "The service slug, e.g. 'groq-llm', 'elevenlabs-tts', 'deepgram-stt'."
},
"latency_score": {
"type": "number",
"description": "Only if you clocked it. 1-5. Prefer last.latency_ms — that is the observation."
},
"quality_score": {
"type": "number",
"description": "Judgement. Output quality 1-5. Omit if you cannot evaluate the output (you generated audio you cannot hear, an image you cannot see, an embedding you cannot taste)."
},
"compliance_score": {
"type": "number",
"description": "Judgement. Audit/retention support 1-5. Omit if you did not read a DPA or policy. Do not guess."
},
"reliability_score": {
"type": "number",
"description": "Judgement. Omit on n=1. One success is not reliability evidence."
}
}
}{
"readOnlyHint": false,
"idempotentHint": false,
"destructiveHint": false
}Prompts
Not advertised
Resources
Not advertised
30-day availability
Aggregated from read-only remote checks; this is not a tool-execution or security guarantee.
- Successful checks
- 1 of 1 (100%)
- Average latency
- 755 ms
- 95th percentile latency
- 755 ms
Maintenance history
Public check and source-refresh events. Editorial and ownership records remain private.
- · probe · passed · 755 ms · metadata changed · 7 tool(s)
Connect from your client
Each snippet registers the same endpoint; pick the client you use.
Claude Code
claude mcp add --transport sse naim-mcp https://mcp.naim.janis7ewski.org/sseCline
{
"mcpServers": {
"naim-mcp": {
"type": "sse",
"url": "https://mcp.naim.janis7ewski.org/sse",
"disabled": false
}
}
}Gemini CLI
gemini mcp add --transport sse naim-mcp https://mcp.naim.janis7ewski.org/sseLet your agent find its tools
Find servers like nAIm MCP from your agent. Add Koskamo once to search the index for endpoints, access requirements, and client setup. Public discovery needs no key.