Lemmy data API
10 endpoints for Lemmy: profile, profile posts, post, post comments, search, trending, community, community posts, community comments, communities. One API key, one JSON schema, as MCP tools or REST.
Endpoints
Call any of them over MCP with call_endpoint and its path, or over REST.
| Endpoint | Returns | Credits | Cache |
|---|---|---|---|
| profileGET /v1/lemmy/profile | A Lemmy user by name@instance: display name, bio, join date, post and comment counts, and their scores. | 1 | 15 min |
| profile/postsGET /v1/lemmy/profile/posts | A Lemmy user's newest posts, with the community, score, comment count and any linked page. | 1 | 10 min |
| postGET /v1/lemmy/post | One Lemmy post by URL, with its engagement counts. | 1 | 10 min |
| post/commentsGET /v1/lemmy/post/comments | Comments on one Lemmy post, replies included. | 1 | 5 min |
| searchGET /v1/lemmy/search | Posts, comments, communities and users on lemmy.ml matching a keyword. | 1 | 2 min |
| trendingGET /v1/lemmy/trending | Top posts of the day on lemmy.ml. | 1 | 30 min |
| communityGET /v1/lemmy/community | One Lemmy community: description, icon, subscriber count and the day, week and month active user counts. | 1 | 15 min |
| community/postsGET /v1/lemmy/community/posts | Posts one Lemmy community ranked for the chosen window, with score and vote split. | 5 | 30 min |
| community/commentsGET /v1/lemmy/community/comments | Comments posted in one Lemmy community, newest or highest scoring first. | 5 | 30 min |
| communitiesGET /v1/lemmy/communities | Top Lemmy communities across the federation, ranked by all-time activity. | 5 | 30 min |
Connect your agent over MCP
Remote MCP server: https://data.openkrill.app/mcp with your key in the x-api-key header.
claude mcp add --transport http krilldata \
https://data.openkrill.app/mcp \
--header "x-api-key: YOUR_API_KEY"{
"mcpServers": {
"krilldata": {
"url": "https://data.openkrill.app/mcp",
"headers": {
"x-api-key": "YOUR_API_KEY"
}
}
}
}{
"mcpServers": {
"krilldata": {
"command": "npx",
"args": [
"-y",
"mcp-remote",
"https://data.openkrill.app/mcp",
"--header",
"x-api-key:${API_KEY}"
],
"env": {
"API_KEY": "YOUR_API_KEY"
}
}
}
}