at-explore-mcp
v0.12.3
Published
MCP server for AT Protocol exploration tools
Maintainers
Readme
AT Explore MCP
Give your AI assistant the ability to explore the social web. This MCP server provides tools for searching users, browsing posts, checking verifications, and more across AT Protocol (Bluesky), ActivityPub (Mastodon, Pixelfed), and Nostr networks.
Quick Start
Add to Claude Desktop config and restart:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"at-explore": {
"command": "npx",
"args": ["-y", "at-explore-mcp"]
}
}
}That's it. Ask Claude about any Bluesky, Mastodon, or Nostr user.
What Can You Do With It?
Once installed, try asking Claude things like:
- "Look up @jay.bsky.team on Bluesky and tell me about them"
- "Find people on Bluesky who work on AI"
- "What are the recent posts from @atproto.com?"
- "Is pfrazee.com a verified handle? How did they set it up?"
- "Who has liked my latest post?" (with authentication)
- "Check if @[email protected] is bridged to Bluesky"
- "What collections does this user have in their AT Protocol repo?"
- "Look up this Nostr npub and show me their profile"
- "What has this Nostr user been posting lately?"
Installation Options
Option 1: npx (Recommended)
Zero installation. Add the config above and go.
Option 2: Global Install
npm install -g at-explore-mcp{
"mcpServers": {
"at-explore": {
"command": "at-explore-mcp"
}
}
}Option 3: Claude Code CLI
For Claude Code, use the hosted HTTP endpoint:
claude mcp add --transport http at-explore https://mcp.atexplore.social/mcpNote: The HTTP endpoint is read-only. For write capabilities (posting, etc.), use local installation.
Features
Bluesky / AT Protocol
| Capability | Tools |
|------------|-------|
| Search & Discovery | search_handles - Find users by name or handle |
| User Profiles | get_user_profile, get_account_document, get_repository_summary |
| Content Browsing | get_user_collection, browse_collection_records, get_record, get_record_by_uri, get_feed |
| Engagement Data | get_all_link_sources, get_profile_backlinks, get_record_backlinks, get_specific_backlinks |
| Verification | verify_handle, get_verification_status, check_verification, get_verifications, get_verifiers |
| Stats & Media | get_at_stats, get_user_blobs, get_user_collections |
| Lexicons | get_lexicon_schema, search_lexicons, validate_lexicon |
| AI Preferences | get_ai_preferences - Read a user's AI consent preferences |
| Links | get_at_explore_link, get_at_explore_link_by_uri |
| Advanced | graphql_query - Execute custom GraphQL queries against the AT Explore API |
ActivityPub (Mastodon, Pixelfed, etc.)
| Capability | Tools |
|------------|-------|
| Profiles | get_activitypub_profile |
| Posts | get_activitypub_posts, get_activitypub_post |
| Stats | get_activitypub_stats |
| Bridge Status | get_bridge_status, get_activitypub_bridge_status |
Nostr
| Capability | Tools |
|------------|-------|
| Profiles | get_nostr_profile - Look up a Nostr user by npub or identifier |
| Posts | get_nostr_posts - Get recent posts from a Nostr user |
| Events | get_nostr_event - Get a specific Nostr event by ID |
Authentication & Writing (Local only)
When running locally via STDIO, you can authenticate with your Bluesky account:
| Tool | Description |
|------|-------------|
| login | OAuth login via browser |
| logout | Clear session |
| whoami | Current user info |
| check_auth | Verify authentication |
| create_post | Post to Bluesky |
| create_record | Create any AT Protocol record |
| update_record | Update a record |
| delete_record | Delete a record |
Authentication
To use write features, authenticate with your Bluesky account:
- Ask Claude to log you in (it will use the
logintool) - A browser opens for OAuth authorization
- Authorize the app
- You're now authenticated for write operations
Sessions are stored locally:
- macOS/Linux:
~/.config/at-explore-mcp/ - Windows:
%APPDATA%\at-explore-mcp\
HTTP API
A read-only HTTP API is available at https://mcp.atexplore.social.
Data Source
Powered by AT Explore, which indexes AT Protocol data for fast queries.
License
MIT
