English Français العربية

io.github.shea256/aiiq-mcp

Official registry AI and agents

Query AI IQ (aiiq.org) model IQ, rankings, benchmarks, and methodology.

Source code Documentation

What can you do with io.github.shea256/aiiq-mcp?

  • list_models — all public models with IQ, 7 dimension scores, emotional reasoning, rank, cost
  • get_model — full detail for one model (incl. per-benchmark results)
  • list_rankings — available leaderboards with ids, names, model counts, and URLs
  • get_ranking — ordered models for one ranking id
  • list_domains — applied-capability domains and benchmark counts
  • get_domain — model composite IQs and benchmark leaderboards for one domain
  • list_benchmarks — benchmark catalog
  • get_methodology — how AI IQ is computed

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

NPM package @aiiq/mcp
Claude Code 
claude mcp add aiiq-mcp -e 'AIIQ_API_BASE=<AIIQ_API_BASE>' -- npx -y @aiiq/mcp@0.2.0
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "aiiq-mcp": {
            "command": "npx",
            "args": [
                "-y",
                "@aiiq/mcp@0.2.0"
            ],
            "env": {
                "AIIQ_API_BASE": "<AIIQ_API_BASE>"
            }
        }
    }
}

Environment variables

  • AIIQ_API_BASE Override the versioned AI IQ API base URL (default https://www.aiiq.org/api/v1).

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. @aiiq/mcp
  2. Install
  3. Tools
  4. Config
  5. Development
  6. License

@aiiq/mcp

Model Context Protocol server for AI IQ — query AI model IQ, rankings, applied-capability domains, benchmarks, and methodology from any MCP client (Claude Code, etc.).

Read-only. Talks to the public AI IQ API over HTTPS; no API key required.

Install

Requires Node.js 18+. No API key needed. Works in any MCP client.

Claude Code (one command):

claude mcp add aiiq -- npx -y @aiiq/mcp          # add --scope user for all projects

Claude Desktop — edit claude_desktop_config.json (Settings → Developer → Edit Config) and add:

{
  "mcpServers": {
    "aiiq": { "command": "npx", "args": ["-y", "@aiiq/mcp"] }
  }
}

Then fully quit and reopen the app. (If Node is managed by nvm/asdf, use the absolute path to npx as the command, since the desktop app doesn't inherit your shell PATH.)

Cursor / Windsurf / other clients — same JSON in the client's MCP config:

{ "mcpServers": { "aiiq": { "command": "npx", "args": ["-y", "@aiiq/mcp"] } } }

Tools

  • list_models — all public models with IQ, 7 dimension scores, emotional reasoning, rank, cost
  • get_model — full detail for one model (incl. per-benchmark results)
  • list_rankings — available leaderboards with ids, names, model counts, and URLs
  • get_ranking — ordered models for one ranking id
  • list_domains — applied-capability domains and benchmark counts
  • get_domain — model composite IQs and benchmark leaderboards for one domain
  • list_benchmarks — benchmark catalog
  • get_methodology — how AI IQ is computed
  • compare_models — side-by-side detail for several models

Config

  • AIIQ_API_BASE — override the versioned API base URL (default https://www.aiiq.org/api/v1). A custom value must be the API root that contains paths such as /models and /rankings.

Development

pnpm install
pnpm test
pnpm build

License

MIT

Frequently asked questions

What is io.github.shea256/aiiq-mcp?

Query AI IQ (aiiq.org) model IQ, rankings, benchmarks, and methodology.

How do I install io.github.shea256/aiiq-mcp?

It runs on your machine. In Claude Code: claude mcp add aiiq-mcp -e 'AIIQ_API_BASE=<AIIQ_API_BASE>' -- npx -y @aiiq/mcp@0.2.0. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.shea256/aiiq-mcp need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.shea256/aiiq-mcp open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.shea256/aiiq-mcp?

It is published by shea256. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.