Semble for Claude

Connect Claude to Semble — save and connect URLs, build collections, explore the discourse graph, and run deep research over your network. Ships as a Claude Code plugin and a Claude Desktop extension.

You'll need a Semble API key: https://semble.so/settings/api-keys

---

What's included

• MCP tools — the full Semble API surface: cards, collections, typed connections, feeds, notifications, semantic search, and social graph.
• Skills (Claude Code only) — strategies Claude invokes automatically:
  • semble-getting-started — core concepts and tool map.
  • semble-deep-research — multi-step search, graph crawling, evaluation, and suggested actions.
  • semble-activity-digest — summarize feeds + notifications, then suggest follow-ups.

---

Install — Claude Code

Via the marketplace (recommended):

/plugin marketplace add https://raw.githubusercontent.com/cosmik-network/semble-claude-plugin/main/marketplace/marketplace.json
/plugin install semble

Or directly from npm:

/plugin install npm:@semble.so/claude-plugin

You'll be prompted for your Semble API key on enable; it's stored in your OS keychain and sent as the X-API-Key header to https://api.semble.so/mcp. It's never written to disk in plaintext.

---

Install — Claude Desktop

Claude Desktop's Custom Connectors only support OAuth, so API-key auth ships as a Desktop Extension (.mcpb).

1. Download semble.mcpb from the latest release.
2. Double-click it — Claude Desktop opens an install dialog.
3. Enter your Semble API key when prompted (stored in your OS keychain).

The extension runs a thin local bridge (mcp-remote) that forwards to the remote Semble MCP server with your key injected.

Skills are a Claude Code feature and are not available in Claude Desktop.

---

Usage

Once installed, just ask:

• "Save this URL to my AI-safety collection and add a note."
• "Research what Semble has on discourse graphs — find the key papers, curators, and collections."
• "Catch me up on Semble — what happened in my network this week?"
• "Connect this paper to that one as SUPPORTS."

Claude picks the right tools and skills automatically. It will confirm before any write (saving, connecting, following, deleting).

---

Development

.claude-plugin/plugin.json   Claude Code plugin manifest + userConfig
.mcp.json                    Remote MCP server config (X-API-Key header)
skills/                      Getting-started, deep-research, activity-digest
marketplace/marketplace.json Self-hosted marketplace catalog
desktop-extension/           .mcpb source (manifest + mcp-remote bridge)
package.json                 npm package (publishes plugin files only)

Publish the plugin to npm:

npm publish --access public

Build the desktop extension:

cd desktop-extension
npm install
npx @anthropic-ai/mcpb pack   # → semble.mcpb

---

License

MIT © Cosmik