Skip to content

Commit 92e9c28

Browse files
committed
Update README.md with MCP server documentation
1 parent f3f1ab9 commit 92e9c28

1 file changed

Lines changed: 33 additions & 0 deletions

File tree

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -44,6 +44,7 @@ COMMANDS:
4444
list-app-passwords Show App-passwords
4545
add-app-password Add App-password
4646
revoke-app-password Revoke App-password
47+
mcp Start MCP server
4748
help, h Shows a list of commands or help for one command
4849
4950
GLOBAL OPTIONS:
@@ -84,6 +85,38 @@ Or install with go install command.
8485
go install github.com/mattn/bsky@latest
8586
```
8687

88+
### MCP Server
89+
90+
`bsky mcp` starts an MCP (Model Context Protocol) server over stdio. This allows AI assistants like Claude to interact with Bluesky directly.
91+
92+
Available tools:
93+
94+
| Tool | Description |
95+
|------|-------------|
96+
| `bluesky_timeline` | Show timeline posts |
97+
| `bluesky_post` | Create a new post |
98+
| `bluesky_search` | Search posts |
99+
| `bluesky_show_profile` | Show a user profile |
100+
| `bluesky_search_actors` | Search for users |
101+
| `bluesky_thread` | Show a post thread |
102+
| `bluesky_notification` | Show notifications |
103+
| `bluesky_like` | Like a post |
104+
| `bluesky_repost` | Repost a post |
105+
| `bluesky_follow` | Follow a user |
106+
107+
Example configuration for Claude Code (`~/.claude/settings.json`):
108+
109+
```json
110+
{
111+
"mcpServers": {
112+
"bsky": {
113+
"command": "bsky",
114+
"args": ["mcp"]
115+
}
116+
}
117+
}
118+
```
119+
87120
### To enable Autocomplete
88121

89122
Download the correct file from `/scripts` directory and add the following line to your shell configuration file.

0 commit comments

Comments
 (0)