Which integrations are available for this server?

Provides semantic search and access to AT Protocol/Bluesky documentation, lexicon schemas, and cookbook examples. Tools include search, lexicon retrieval, and cookbook example lookup.

How do I use atproto-mcp?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@atproto-mcp search for creating a post in AT Protocol" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

atproto-mcp

by Ashex

Overview Schema Related Servers Score Discussions

Python

Local

atproto-mcp

Tests

MCP server providing a searchable knowledge base for the AT Protocol ecosystem — protocol documentation, lexicon schemas, Bluesky developer API docs, and cookbook examples — powered by txtai semantic search.

Data Sources

Source	Repository	Description
AT Protocol Website	bluesky-social/atproto-website	Protocol specs, guides, and blog posts from atproto.com
Bluesky API Docs	bluesky-social/bsky-docs	Developer docs from docs.bsky.app — tutorials, guides, advanced topics
AT Protocol Lexicons	bluesky-social/atproto	JSON schemas defining all AT Protocol endpoints and record types
Cookbook	bluesky-social/cookbook	Example projects in Python, Go, TypeScript, and JavaScript

Related MCP server: mcpbluesky

Tools

Tool	Description
`search_atproto_docs`	Semantic search across all documentation sources
`get_lexicon`	Retrieve a specific lexicon by NSID (e.g. `app.bsky.feed.post`)
`list_lexicons`	List all lexicons, optionally filtered by namespace
`search_lexicons`	Semantic search within lexicon schemas
`get_cookbook_example`	Get a specific cookbook example by project name
`list_cookbook_examples`	List all cookbook examples, optionally by language
`search_bsky_api`	Semantic search within Bluesky API docs
`refresh_sources`	Force re-fetch repos and rebuild the index

Prompts

Prompt	Description
`explain_lexicon`	Get a comprehensive explanation of a lexicon
`implement_feature`	Get implementation guidance with code examples
`debug_atproto`	Help debug AT Protocol / Bluesky API issues
`explore_namespace`	Explore all lexicons in a namespace

Installation

Prerequisites

Python 3.10+
uv (recommended) or pip
Git (for cloning source repositories)

Install from source

git clone https://github.com/ashex/atproto-mcp.git
cd atproto-mcp
uv sync

Run with uvx

uvx atproto-mcp

Configuration

VS Code / Copilot

Install in VS Code

Add to .vscode/mcp.json in your workspace:

{
  "mcpServers": {
    "atproto": {
      "command": "uvx",
      "args": [
        "atproto-mcp"
        ]
    }
  }
}

Kiro Power

Open Kiro → Powers
Select Import power from GitHub
Enter https://github.com/ashex/atproto-mcp

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "atproto": {
      "command": "uvx",
      "args": [
         "atproto-mcp"
      ]
    }
  }
}

MCPHub

Add to ~/.config/mcphub/servers.json:

{
  "mcpServers": {
    "atproto": {
      "command": "uvx",
      "args": ["atproto-mcp"]
    }
  }
}

OpenCode

Add to your opencode.json:

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "atproto": {
      "type": "local",
      "command": ["uvx", "atproto-mcp"]
    }
  }
}

Environment Variables

Variable	Default	Description
`ATPROTO_MCP_CACHE_DIR`	`~/.cache/atproto-mcp`	Where repos and the search index are stored
`ATPROTO_MCP_REFRESH_HOURS`	`24`	Hours before re-fetching repositories
`ATPROTO_MCP_EMBEDDING_MODEL`	`sentence-transformers/all-MiniLM-L6-v2`	Sentence-transformers model for embeddings

How It Works

On first launch, the server:

Shallow clones the repos into ~/.cache/atproto-mcp/repos/
Parses MDX docs, lexicon schemas, and cookbook examples into text chunks
Indexes the chunks using txtai with the all-MiniLM-L6-v2 sentence-transformer model (~80MB, runs locally)
Index is persisted in ~/.cache/atproto-mcp/index/ for subsequent starts

On subsequent launches, the cached index loads in seconds. Repos older than 24 hours are automatically refreshed with git pull.

Development

# Install in development mode
uv sync

# Run the server locally (stdio)
uv run atproto-mcp

# Test with the MCP Inspector
uv run mcp dev src/atproto_mcp/server.py

# Run with debug logging
ATPROTO_MCP_CACHE_DIR=/tmp/atproto-mcp uv run atproto-mcp

License

MIT

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

1Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly
Lightport: Open-Sourcing Glama's AI Gateway
By punkpeye on April 27, 2026.
OpenAI
open source

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Ashex/atproto-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server