Skip to content

Commit 40c691f

Browse files
rianvdmclaude
rianvdm
and
claude
committed
docs: refresh tool lists for v3.1.0
README, marketing page, auth_status, and server_info were all advertising only 5 of the 15 authenticated tools. Updated all four spots with grouped categories (Search, Collection, Folders, Custom Fields, Diagnostics) and bumped the server_info version string from v1.0.0 to v3.1.0. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
1 parent c47fa89 commit 40c691f

3 files changed

Lines changed: 77 additions & 14 deletions

File tree

‎README.md‎

Lines changed: 39 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -147,13 +147,45 @@ This server uses **MCP OAuth 2.1** with Discogs as the identity provider. When y
147147

148148
### 🔐 Authenticated Tools (Requires Login)
149149

150-
| Tool | Description |
151-
| ---------------------- | --------------------------------------------------------------- |
152-
| `search_collection` | Search your collection with intelligent mood and genre matching |
153-
| `get_release` | Get detailed information about a specific release |
154-
| `get_collection_stats` | View comprehensive collection statistics |
155-
| `get_recommendations` | Get context-aware music recommendations |
156-
| `get_cache_stats` | Monitor cache performance (development) |
150+
**Search & discovery**
151+
152+
| Tool | Description |
153+
| ---------------------- | ---------------------------------------------------------------------------- |
154+
| `search_collection` | Search your collection with explicit genre filters, mood-aware ranking, and master-level dedup |
155+
| `get_release` | Get detailed information about a specific release (tracklist, formats, labels) |
156+
| `get_collection_stats` | View genre breakdown, decade analysis, format distribution, and ratings |
157+
| `get_recommendations` | Get personalized recommendations by genre, decade, mood, or similarity |
158+
159+
**Collection management**
160+
161+
| Tool | Description |
162+
| ------------------------ | --------------------------------------------------------------------------- |
163+
| `add_to_collection` | Add a release to a folder (defaults to Uncategorized) |
164+
| `remove_from_collection` | Remove a specific release instance from a folder |
165+
| `move_release` | Move a release instance between folders |
166+
| `rate_release` | Rate a release from 0 (no rating) to 5 stars |
167+
168+
**Folders**
169+
170+
| Tool | Description |
171+
| ---------------- | ------------------------------------------------------------------- |
172+
| `list_folders` | List all folders with release counts |
173+
| `create_folder` | Create a new folder |
174+
| `edit_folder` | Rename an existing folder (system folders excluded) |
175+
| `delete_folder` | Delete an empty folder (system folders excluded) |
176+
177+
**Custom fields**
178+
179+
| Tool | Description |
180+
| -------------------- | ------------------------------------------------------------------------------------ |
181+
| `list_custom_fields` | List all custom fields defined on your collection |
182+
| `edit_custom_field` | Set a custom field value on a specific release instance |
183+
184+
**Diagnostics**
185+
186+
| Tool | Description |
187+
| ----------------- | ------------------------------------------------------------------- |
188+
| `get_cache_stats` | View cache performance (total entries, pending requests, breakdown) |
157189

158190
## 📚 MCP Resources
159191

‎src/marketing-page.ts‎

Lines changed: 31 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -570,12 +570,42 @@ export const MARKETING_PAGE_HTML = `<!DOCTYPE html>
570570
</ul>
571571
</div>
572572
<div class="tool-col">
573-
<h3>Personal (auth required)</h3>
573+
<h3>Search &amp; discovery</h3>
574574
<ul>
575575
<li>search_collection</li>
576576
<li>get_release</li>
577577
<li>get_collection_stats</li>
578578
<li>get_recommendations</li>
579+
</ul>
580+
</div>
581+
<div class="tool-col">
582+
<h3>Collection management</h3>
583+
<ul>
584+
<li>add_to_collection</li>
585+
<li>remove_from_collection</li>
586+
<li>move_release</li>
587+
<li>rate_release</li>
588+
</ul>
589+
</div>
590+
<div class="tool-col">
591+
<h3>Folders</h3>
592+
<ul>
593+
<li>list_folders</li>
594+
<li>create_folder</li>
595+
<li>edit_folder</li>
596+
<li>delete_folder</li>
597+
</ul>
598+
</div>
599+
<div class="tool-col">
600+
<h3>Custom fields</h3>
601+
<ul>
602+
<li>list_custom_fields</li>
603+
<li>edit_custom_field</li>
604+
</ul>
605+
</div>
606+
<div class="tool-col">
607+
<h3>Diagnostics</h3>
608+
<ul>
579609
<li>get_cache_stats</li>
580610
</ul>
581611
</div>

‎src/mcp/tools/public.ts‎

Lines changed: 7 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -47,7 +47,7 @@ export function registerPublicTools(server: McpServer, env: Env, getSessionConte
4747
content: [
4848
{
4949
type: 'text',
50-
text: `Discogs MCP Server v1.0.0\n\nStatus: Running\nProtocol: MCP 2024-11-05\nFeatures:\n- Resources: Collection, Releases, Search\n- Authentication: OAuth 1.0a\n- Rate Limiting: Enabled\n\nTo get started, authenticate at ${authUrl}`,
50+
text: `Discogs MCP Server v3.1.0\n\nStatus: Running\nProtocol: MCP 2024-11-05\nFeatures:\n- Resources: Collection, Releases, Search\n- Authentication: OAuth 1.0a\n- Rate Limiting: Enabled\n\nTo get started, authenticate at ${authUrl}`,
5151
},
5252
],
5353
}
@@ -73,11 +73,12 @@ You are successfully authenticated with Discogs!
7373
- Session expires: ${new Date(session.exp * 1000).toISOString()}
7474
7575
**Available tools:**
76-
- search_collection: Search your music collection
77-
- get_release: Get release details
78-
- get_collection_stats: View collection statistics
79-
- get_recommendations: Get personalized recommendations
80-
- get_cache_stats: View cache performance`,
76+
77+
*Search & discovery:* search_collection, get_release, get_collection_stats, get_recommendations
78+
*Collection management:* add_to_collection, remove_from_collection, move_release, rate_release
79+
*Folders:* list_folders, create_folder, edit_folder, delete_folder
80+
*Custom fields:* list_custom_fields, edit_custom_field
81+
*Diagnostics:* get_cache_stats`,
8182
},
8283
],
8384
}

0 commit comments

Comments
 (0)