Mastodon Instances

Mastodon Instances (instances.social) is a service for discovering Mastodon server instances. Its API allows developers to search for instances by criteria including language, user count, and stability, and to retrieve metadata about specific instances.

Mastodon Instances publishes 2 APIs on the APIs.io network: Instances API and Versions API. Tagged areas include Fediverse, Mastodon, Search, and Social.

Mastodon Instances’ developer surface includes authentication, developer portal, signup flow, and 2 more developer resources.

🌐 Visit website 📡 Source on GitHub

30.1/100 thin ▬ flat Agent 23/100 agent aware Full breakdown ↓
scored 2026-08-25 · rubric v0.14.0

AccessFreemiumSelf serve⚡ Free to try

3 APIs

Fediverse Mastodon Search Social

Kin Score

Kin Score How this is scored →
scored 2026-08-25 · rubric v0.14.0

Composite quality — 30.1/100 · thin

Contract Quality 12.6 / 25

Developer Ergonomics 4.3 / 20

Access Clarity 5.8 / 20

Operational Transparency 1.0 / 13

Contract Governance 0.0 / 12

Discoverability 6.5 / 10

Agent readiness — 23/100 · agent aware

Machine-Readable Contract 18 / 18

Agentic Access Contract 10 / 10

Documented Reversibility 6 / 6

MCP Server 0 / 12

Machine-Readable Auth 10 / 10

Idempotency 9 / 9

Stable Error Semantics 0 / 8

Request/Response Examples 0 / 7

Rate-Limit Signaling 7 / 7

Typed Event Surface 0 / 6

Agent Skills 0 / 5

Well-Known Catalog 0 / 4

Consent & Bot Identity 0 / 3

A2A Agent Card 0 / 8

Dry-Run / Simulate Mode 4 / 4

Delegated User Identity 0 / 6

Protected Resource Metadata 0 / 5

Registration Without a Human 0 / 6

Agentic Commerce Surface 0 / 5

Improve this rating by publishing the missing artifacts — every area above can be raised, and the full rubric is at apis.io/rating/. This rating is computed from github.com/api-evangelist/mastodon-instances: open an issue to ask a question, or submit a pull request to add artifacts. Want it done for you? Prioritized profiling — $2,500 →

APIs 3

Individual APIs this provider publishes, each with its own machine-readable definition.

Rate Limits 1

Documented rate limits and quota policies.

Mastodon Instances Rate Limits

5 limits

RATE LIMITS

FinOps 1

Cost, billing, and metering signals for API financial operations.

AGENTIC

Resources

Get Started 2

Portal, sign-up, and the first successful call

Portal

Portal

Signup

Signup

Agent Surfaces 1

MCP servers, agent skills, and machine-readable catalogs

AgenticAccess

AgenticAccess

Access & Security 2

Authentication, authorization, and security posture

DomainSecurity

DomainSecurity

Authentication

Authentication

Source (apis.yml)

aid: mastodon-instances
name: Mastodon Instances
description: Mastodon Instances (instances.social) is a service for discovering Mastodon server instances. Its API allows
  developers to search for instances by criteria including language, user count, and stability, and to retrieve metadata about
  specific instances.
type: Index
accessModel:
  pricing: freemium
  onboarding: self-serve
  trial: false
  try_now: true
  public: false
  label: Freemium · Self-serve signup
  confidence: high
  source:
  - plans
  - authentication
  generated: '2026-07-22'
  method: derived
image: https://kinlane-images.s3.amazonaws.com/shared/apis-json/icons/mastodon-instances.png
url: https://raw.githubusercontent.com/api-evangelist/mastodon-instances/refs/heads/main/apis.yml
tags:
- Fediverse
- Mastodon
- Search
- Social
created: '2024-12-02'
modified: '2026-04-28'
specificationVersion: '0.23'
apis:
- aid: mastodon-instances:mastodon-instances
  name: Mastodon Instances API
  tags:
  - Mastodon
  - Search
  - Social
  humanURL: https://instances.social
  baseURL: https://instances.social/api
  properties:
  - url: https://instances.social/api/doc/
    type: Documentation
  description: The instances.social API allows searching for and retrieving information about Mastodon server instances, including
    user counts, language, software version, and uptime statistics.
- aid: mastodon-instances:mastodon-instances-instances-api
  name: Mastodon Instances Instances API
  description: The Instances API from Mastodon Instances — 4 operation(s) for instances.
  humanURL: https://instances.social
  baseURL: https://instances.social/api
  tags:
  - Instances
  properties:
  - type: OpenAPI
    url: openapi/mastodon-instances-instances-api-openapi.yml
- aid: mastodon-instances:mastodon-instances-versions-api
  name: Mastodon Instances Versions API
  description: The Versions API from Mastodon Instances — 2 operation(s) for versions.
  humanURL: https://instances.social
  baseURL: https://instances.social/api
  tags:
  - Versions
  properties:
  - type: OpenAPI
    url: openapi/mastodon-instances-versions-api-openapi.yml
common:
- type: AgenticAccess
  url: agentic-access/mastodon-instances-agentic-access.yml
- type: DomainSecurity
  url: security/mastodon-instances-domain-security.yml
- type: Authentication
  url: authentication/mastodon-instances-authentication.yml
- type: Portal
  url: https://instances.social
- type: Signup
  url: https://instances.social/api/token
maintainers:
- FN: Kin Lane
  email: kin@apievangelist.com

Work with this as data

Every provider here is available over the APIs.io API and to AI agents over MCP.

MCP server

One button, every client — Claude, Cursor, VS Code and the rest.

https://apis.io/mcp

Tools for providers

9 MCP tools reach this

find_providersBrowse and filter every provider in the catalog.
get_provider_artifactsEvery artifact this provider publishes, grouped by type.
get_provider_operationsEvery operation across all of their OpenAPIs — one call instead of parsing every spec.
get_provider_toolsEvery MCP tool they ship, with the operation each wraps.
get_provider_evidenceHow each part of their score was established. Free — the basis for a claim should not sit behind it.
get_provider_ratingPRO — composite, band, trend and facet scores.
apis_io_searchSTART HERE — APIs, providers and tags for one query, each with its total.
resolveTurn a domain, URL or GitHub org into the provider it belongs to.
find_cohortsEvery scored population of providers in the catalog.

All 92 tools

Call it yourself

curl for this page

This provider

curl "https://apis.io/api/v1/providers/mastodon-instances"

All providers

curl "https://apis.io/api/v1/providers?limit=25"

Every operation they expose

curl "https://apis.io/api/v1/providers/mastodon-instances/operations?limit=25"

How their score was established

curl "https://apis.io/api/v1/providers/mastodon-instances/evidence"

Discovery needs no key. Ratings and market analysis are Pro.

Get an API key

Free tier, no email required.

GitHub Google LinkedIn

A second provider on the same verified email joins the account you already have.

Mastodon Instances

Kin Score

APIs 3

Mastodon Instances API

Mastodon Instances Instances API

Mastodon Instances Versions API

Open Collections 4

API Collection

Mastodon Instances API

Mastodon Instances Versions API

Mastodon Instances API

Pricing Plans 1

Mastodon Instances Plans Pricing

Rate Limits 1

Mastodon Instances Rate Limits

FinOps 1

Mastodon Instances Finops

Security Posture 2

Mastodon Instances Authentication

Mastodon Instances Domain Security

Agentic Access 1

Mastodon Instances Agentic Access

Resources

Get Started 2

Agent Surfaces 1

Access & Security 2

Source (apis.yml)

Work with this as data

MCP server

Tools for providers

Call it yourself

Get an API key