AT Explore MCP Server

A Model Context Protocol (MCP) server that provides AI assistants with tools to explore and interact with AT Protocol (Bluesky) and ActivityPub (Mastodon, Pixelfed) data.

Features

Read-Only Tools (Available everywhere)

• Search Handles: Find user handles and profiles
• User Profiles: Get detailed profile information
• User Collections: Access user's posts, likes, reposts, follows, etc.
• Verification Status: Check domain verification for users
• Record Lookup: Get specific AT Protocol records
• Backlinks: Find who liked, reposted, or replied to content
• ActivityPub Integration: Explore federated content from Mastodon, Pixelfed, etc.

Authentication & Write Tools (Local STDIO only)

• OAuth Login: Authenticate with your Bluesky account
• Create Posts: Post to Bluesky directly
• Manage Records: Create, update, and delete AT Protocol records

Installation

Option 1: npx (Recommended)

No installation required. Configure Claude Desktop to run directly:

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"]
    }
  }
}

Restart Claude Desktop after saving.

Option 2: Global Install

npm install -g at-explore-mcp

Then configure Claude Desktop:

{
  "mcpServers": {
    "at-explore": {
      "command": "at-explore-mcp"
    }
  }
}

Option 3: Claude Code CLI (HTTP - Read-Only)

For Claude Code, use the hosted HTTP endpoint:

claude mcp add --transport http at-explore https://mcp.atexplore.social/mcp

Verify with:

claude mcp list

Note: The HTTP endpoint provides read-only tools. For authentication and write capabilities, use the local STDIO installation (Option 1 or 2).

Option 4: From Source

git clone https://github.com/johnwhiteside/at-explore-mcp.git
cd at-explore-mcp
npm install
npm run build

Configure Claude Desktop to use the local build:

{
  "mcpServers": {
    "at-explore": {
      "command": "node",
      "args": ["/path/to/at-explore-mcp/build/index.js"]
    }
  }
}

Available Tools

Read-Only Tools

| Tool | Description | |------|-------------| | search_handles | Search for user handles | | get_user_profile | Get user profile information | | get_account_document | Get DID document and verification status | | get_repository_summary | Get repository metadata and collection stats | | get_user_collections | List all collections for a user | | get_user_collection | Get records from a specific collection | | browse_collection_records | Browse paginated collection records | | get_verification_status | Check verification status | | verify_handle | Comprehensive domain handle verification | | get_verifications | Get list of verifications | | get_verifiers | Get list of verifiers | | check_verification | Check if a user is verified | | get_record | Get a specific AT Protocol record | | get_record_by_uri | Get record by AT URI | | get_at_explore_link | Generate AT Explore web link | | get_at_explore_link_by_uri | Generate AT Explore link from URI | | get_all_link_sources | Get engagement stats (likes, reposts, follows) | | get_specific_backlinks | Get backlink records for a collection | | get_profile_backlinks | Get backlinks to a user's profile | | get_record_backlinks | Get backlinks to a specific record | | get_at_stats | Get follower/following/posts counts | | get_user_blobs | Get list of blob CIDs for a user | | get_bridge_status | Check Bridgy Fed status for AT account | | get_activitypub_profile | Get ActivityPub user profile | | get_activitypub_posts | Get posts from ActivityPub user | | get_activitypub_post | Get specific ActivityPub post | | get_activitypub_stats | Get ActivityPub user stats | | get_activitypub_bridge_status | Check Bridgy Fed status for AP account |

Authentication Tools (STDIO only)

| Tool | Description | |------|-------------| | login | Authenticate with Bluesky via OAuth | | logout | Clear authentication session | | whoami | Get current authenticated user info | | check_auth | Check if authenticated |

Write Tools (STDIO only, requires authentication)

| Tool | Description | |------|-------------| | create_post | Create a new Bluesky post | | create_record | Create any AT Protocol record | | update_record | Update an existing record | | delete_record | Delete a record |

ActivityPub Support

The MCP server now includes support for exploring federated ActivityPub content from platforms like Mastodon, Pixelfed, and other compatible services.

Supported Platforms

• ✅ Mastodon: Full support for profiles, posts, and pagination
• ✅ Pixelfed: Profile support (posts may be restricted by platform)
• ⚠️ Meta Threads: Limited federation (experimental)

Usage Examples

// Get a Mastodon user profile
get_activitypub_profile({ handle: "[email protected]" })

// Get posts with pagination
get_activitypub_posts({ handle: "[email protected]" })

// Get next page of posts
get_activitypub_posts({
  handle: "[email protected]",
  page: "https://mastodon.social/users/user/outbox?max_id=123&page=true"
})

// Get individual post
get_activitypub_post({
  handle: "[email protected]",
  postId: "aHR0cHM6Ly9tYXN0b2Rvbi5zb2NpYWwvdXNlcnMvdXNlci9zdGF0dXNlcy8xMjM"
})

Authentication

The STDIO server supports OAuth authentication with Bluesky:

1. Use the login tool with your Bluesky handle
2. A browser window opens for OAuth authorization
3. After authorizing, your session is stored locally
4. Use whoami to verify your authenticated identity
5. Use logout to clear the session

Sessions are stored in:

• macOS/Linux: ~/.config/at-explore-mcp/
• Windows: %APPDATA%\at-explore-mcp\

Development

npm install          # Install dependencies
npm run build        # Build TypeScript
npm run dev          # Watch mode
npm run mcp          # Run STDIO server locally
npm test             # Run tests
npm run test:smoke   # Run smoke tests

Hosted HTTP API

A read-only HTTP API is hosted at https://mcp.atexplore.social. See the API documentation for available endpoints.

Data Source

This MCP server queries the AT Explore API for AT Protocol data.

License

MIT