Sherdog MMA Scraper

Sports Data

Operated by Sourcelane✓ verified

A web-scraping connector that extracts structured MMA data from Sherdog: comprehensive fighter profiles, parsed career records with method-of-victory breakdowns, complete professional fight histories (per-bout details including opponent, event, date, outcome, finishing method, referee, round and time), event fight cards (one row per bout with both fighters, their pre-fight records, result and bout metadata), upcoming-events calendar across promotions, and organization event lists. Technical capabilities include site scraping and normalization into tabular, JSON/CSV-friendly outputs with numeric fields for counts, ISO-format dates, absolute URLs, automatic pagination for organization histories, and a name-based fighter search that returns basic fighter metadata and identifiers. Coverage includes major and regional promotions listed on Sherdog (UFC, PFL, Bellator, ONE, KSW, Cage Warriors, Rizin, and others).

Verified Sep 28, 12:10 AM

$0.004

per result

Up to 100 per call. Only pay for results returned; failed calls are refunded.

What people use it for

MMA betting models — build fighter form, finish-rate and method-of-victory features from complete fight histories
Fan sites and apps — power fighter pages, event previews and result feeds without maintaining your own scraper
Fighter comparison tools — head-to-head records, finish breakdowns, and analysis of common opponents
Sports journalism — fact-check fighter records and pull full cards and results for events quickly
Fantasy MMA and pick'em — keep upcoming cards and matchups in sync for contests and drafts

Trust & reliability

7d uptime trend

Window	Uptime	Success rate	p50	p95
24h	—	—	—	—
7d	—	—	—	—
30d	—	—	—	—

Calling contract

Call it through Sourcelane's gateway or MCP server. We run the connector, apply your agent's spend guardrails, and bill only the results returned.

Call it via Sourcelane

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"sherdog-mma-scraper","params":{"mode":"fighter","maxItems":5},"maxResults":10}'

Request params

Field	Type	Required	Description
`mode`	string	required	What to scrape. Fighter = full profile + fight history per fighter. Event = every bout on a fight card. Upcoming events = the global upcoming-events calendar. Organization = all events (upcoming + past) of a promotion. Search = find fighters by name via the fight finder.
`fighters`	array	optional	Fighter mode only. One per line: a Sherdog fighter URL (https://www.sherdog.com/fighter/Jon-Jones-27944) or a fighter name ('Islam Makhachev'). Names are resolved through the fight finder and the best-matching fighter is used.
`events`	array	optional	Event mode only. Sherdog event page URLs, one per line, e.g. https://www.sherdog.com/events/UFC-309-Jones-vs-Miocic-103896. Every bout on the card becomes one row.
`organizations`	array	optional	Organization mode only. Sherdog organization page URLs, one per line, e.g. https://www.sherdog.com/organizations/Ultimate-Fighting-Championship-UFC-2. Returns the promotion's upcoming events followed by its past events, newest first.
`query`	string	optional	Search mode only. Fighter name or partial name to look up in the fight finder, e.g. 'Adesanya'.
`promotionFilter`	string	optional	Upcoming events mode only. Keep only events whose promotion or name contains this text (case-insensitive), e.g. 'UFC', 'PFL', 'ONE Championship'. Leave empty for all promotions.
`includeMainEvent`	boolean	optional	Upcoming events and organization modes. Opens each event page to fill in the main event ('Fighter A vs. Fighter B') and the full promotion name. Adds one page load per event — turn off for faster runs.
`maxItems`	integer	optional	Maximum number of rows to return per run across all inputs (fighters, bouts, events or search results depending on the mode). 0 = unlimited. Capped at 100 per call.

Each result contains

Field	Type	Description
`fighterId`	integer	Fighter Id
`name`	string	Name
`url`	string	Url
`nickname`	string	Nickname
`height`	string	—
`heightCm`	integer	Height Cm
`weight`	string	—
`weightKg`	number	Weight Kg
`association`	string	—
`scrapedAt`	string	—

Use Sherdog MMA Scraper from Claude, ChatGPT or Cursor

Pick your tool and connect in under a minute. Then just ask — for example: “What are the current odds for this weekend's Premier League matches?”

Connect Claude

Web, desktop and mobile. Paste one URL.

1Copy your personal connector URL
2In Claude open Settings → Connectors → Add custom connector
3Paste the URL and click Add — done

Manual setup (config files, REST, Python) +

Claude Code

Adds the Sourcelane MCP server with your key as a header.

terminal

claude mcp add --transport http sourcelane https://cool-puffin-608.convex.site/mcp \
  --header "Authorization: Bearer sl_live_your_agent_key"

Claude Desktop (config file)

Alternative to the connector URL: add to claude_desktop_config.json, then restart Claude.

claude_desktop_config.json

{
  "mcpServers": {
    "sourcelane": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cool-puffin-608.convex.site/mcp",
        "--header",
        "Authorization:${AUTH_HEADER}"
      ],
      "env": {
        "AUTH_HEADER": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

Cursor & Windsurf

Add to ~/.cursor/mcp.json (or Windsurf's mcp_config.json).

mcp.json

{
  "mcpServers": {
    "sourcelane": {
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer sl_live_your_agent_key"
      }
    }
  }
}

VS Code

Save as .vscode/mcp.json. VS Code prompts for your key once.

.vscode/mcp.json

{
  "servers": {
    "sourcelane": {
      "type": "http",
      "url": "https://cool-puffin-608.convex.site/mcp",
      "headers": {
        "Authorization": "Bearer ${input:sourcelane-key}"
      }
    }
  },
  "inputs": [
    {
      "type": "promptString",
      "id": "sourcelane-key",
      "description": "Sourcelane agent key",
      "password": true
    }
  ]
}

ChatGPT Custom GPT (Actions)

Create a GPT → Actions → Import from URL, then Authentication: API Key, Bearer.

OpenAPI schema URL

https://sourcelane-amber.vercel.app/openapi.json

REST

One POST. Pass maxResults to cap cost.

curl

curl -X POST https://cool-puffin-608.convex.site/v1/call \
  -H "Authorization: Bearer sl_live_your_agent_key" \
  -H "Content-Type: application/json" \
  -d '{"listing":"sherdog-mma-scraper","params":{"mode":"fighter","maxItems":5},"maxResults":10}'

Python, LangChain, CrewAI, OpenAI Agents SDK…

Wrap the REST call as a tool, or point an MCP client at the endpoint.

python

import requests

res = requests.post(
    "https://cool-puffin-608.convex.site/v1/call",
    headers={"Authorization": "Bearer sl_live_your_agent_key"},
    json={
        "listing": "sherdog-mma-scraper",
        "params": {"mode":"fighter","maxItems":5},
        "maxResults": 10,
    },
    timeout=300,
)
body = res.json()
print(body["receipt"]["chargedMicros"], "micro-USD for", body["receipt"]["results"], "results")
print(body["data"])

Reviews

—

0 reviews

Leave a review

Loading reviews…