# Mastodon Instances

**Canonical:** https://apis.io/providers/mastodon-instances/  
**Website:** https://instances.social  
**APIs profiled:** 3

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.

## Kin Score — 30.1 / 100 (thin)

Scored 2026-08-25 under rubric 0.14.0. Trend: flat (+0.0 from 30.1).

| Facet | Score |
|---|---|
| Discoverability | 64.8 |
| Contract Quality | 50.3 |
| Governance | 0.0 |
| Contract Governance | 0.0 |
| Operational Transparency | 7.9 |
| Developer Ergonomics | 21.4 |
| Commercial Clarity | 28.9 |
| Access Clarity | 28.9 |

## Agent readiness — 22.9 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | na |
| MCP Server | no |
| Auth Clarity | bearer |
| Idempotency | na |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | na |
| Delegated Identity | no |
| Protected Resource Metadata | no |
| Dynamic Client Registration | no |
| Agentic Commerce | no |

## Access

Freemium · Self-serve signup — onboarding: self-serve, pricing: freemium, trial: no (confidence: high).

## APIs (3)

- **Mastodon Instances API** — The instances.social API allows searching for and retrieving information about Mastodon server instances, including user counts, language, software version, and uptime statistics.
- **Mastodon Instances Instances API** — The Instances API from Mastodon Instances — 4 operation(s) for instances.
- **Mastodon Instances Versions API** — The Versions API from Mastodon Instances — 2 operation(s) for versions.

## Agentic access (1)

- **Mastodon Instances Agentic Access** — 6 operations

## Security (2)

- **Mastodon Instances Authentication** — http · 1 scheme
- **Mastodon Instances Domain Security** — TLSv1.3 · HSTS · DNSSEC

## Plans (1)

- **Mastodon Instances Plans Pricing**

## Tags

Fediverse, Mastodon, Search, Social

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/mastodon-instances/). Scores are computed from the provider's own public artifacts under a published rubric.