Developer Docs

REST API · MCP Server · FNI Badge

All endpoints are free, no authentication required

REST API

GET /api/v1/search

Search and rank AI models, tools, datasets, and papers by FNI score.

Parameters

Param Type Default Description
q string - Search query (required)
limit number 5 Max results (1-5, free tier)
type string all Filter: model, tool, dataset, paper

Example

curl "https://free2aitools.com/api/v1/search?q=code+generation&limit=2"

Response

{
  "version": "fni_v2.0",
  "results": [
    {
      "id": "meta-llama/Llama-3-8B",
      "name": "Llama 3 8B",
      "type": "model",
      "fni_score": 87.2
    },
    {
      "id": "deepseek-ai/DeepSeek-V3",
      "name": "DeepSeek V3",
      "type": "model",
      "fni_score": 83.5
    }
  ],
  "meta": {
    "elapsed_ms": 42,
    "total": 2
  }
}
Rate Limits: Free tier — 1,000 requests/month, max 5 results per query. CDN cached (30min). No API key required.

MCP Server

Free2AI exposes an MCP server so AI agents (Claude, Cursor, Windsurf, etc.) can discover and rank AI tools automatically.

free2ai_search

Search and rank AI tools, models, datasets, and papers by FNI score.

free2ai_rank

Rank AI tools by FNI score for a given task context. Ideal for AI agents selecting the best tool.

free2ai_explain

Explain why a specific entity received its FNI ranking score with factor breakdown.

Setup

Claude Desktop / Claude Code

Add to your MCP settings (claude_desktop_config.json or .mcp.json): 

{
  "mcpServers": {
    "free2ai": {
      "url": "https://free2aitools.com/api/mcp",
      "transport": "streamable-http"
    }
  }
}

Cursor

Go to Settings > MCP Servers > Add Server, enter:

URL: https://free2aitools.com/api/mcp
Transport: Streamable HTTP

Windsurf

Go to Cascade > Plugins > Add MCP Server, enter:

URL: https://free2aitools.com/api/mcp
Transport: Streamable HTTP

Any MCP Client / Auto-Discovery

Endpoint: POST https://free2aitools.com/api/mcp

Protocol: JSON-RPC 2.0 (MCP Spec 2025-03-26). Supports initialize, tools/list, tools/call.

Machine-readable server manifest: https://free2aitools.com/.well-known/mcp.json

FNI Badge

Embed a live FNI score badge in your README, docs, or website. The badge updates automatically as scores change.

Endpoint

GET https://free2aitools.com/api/v1/badge/{umid}

Returns an SVG image. Color-coded: green (90+), blue (70+), yellow (50+), red (<50). Cached 1 hour at CDN edge.

Markdown (README)

![FNI Score](https://free2aitools.com/api/v1/badge/YOUR_UMID)

HTML

<img src="https://free2aitools.com/api/v1/badge/YOUR_UMID" alt="FNI Score" />
Finding your UMID: Search for your model/tool using the API, the id field in the response is your UMID.

Open Data

For bulk access and offline analysis, download FNI rankings as Apache Parquet files. Compatible with DuckDB, Pandas, Spark, and any columnar data tool.

View Open Data Downloads

FNI Score

Every entity is ranked by the Free2AITools Nexus Index (FNI) — a composite score from 0 to 99.9 based on five factors:

FNI = 0.35·S + 0.25·A + 0.15·P + 0.15·R + 0.10·Q
S
Semantic
A
Authority
P
Popularity
R
Recency
Q
Quality
Full methodology and anti-manipulation details →

Build with Free2AI

Hundreds of thousands of AI entities · FNI-ranked · Updated daily

GitHub FNI Methodology