{"server":"bindly-mcp","url":"https://mcp.bind.ly/mcp","protocol":"streamable-http","tools":[{"name":"mcp_get_binding","description":"Retrieve a Binding. **Works without auth** for public Bindings; requires auth for private ones. Use when the user wants to read, review, or reference a specific piece of knowledge. Tier controls how much content is returned:   • Tier 1  (~300 tokens)  — title, summary, keyPoints, entities. Use for planning or deciding whether to fetch more.   • Tier 1.5 (~800 tokens) — Tier 1 + first ~500 chars of content. Use as a preview to decide if Tier 2 is needed. Default.   • Tier 2  (full content)  — all of the above + full source content. Use when the user needs the complete text. Response includes versionId (UUID string) and version (number) of the current version."},{"name":"mcp_get_bindings","description":"Batch retrieve multiple Bindings in one call. **Works without auth** for public Bindings. Use instead of calling mcp_get_binding repeatedly when you need several Bindings at once (avoids N+1 calls). Max 50 IDs. Same tier options as mcp_get_binding."},{"name":"mcp_list_bindings","description":"List Bindings in a Space. **Works without auth** for public Spaces. Use to browse a Space's contents or when the user asks \"what's in this space?\" or \"show me my bindings\". Returns Tier 1 summaries. Call mcp_get_binding with tier 2 to read full content. Get spaceId from mcp_list_spaces."},{"name":"mcp_create_binding","description":"**Requires authentication.** Create a new Binding with an initial Version. Use when the user asks you to save, remember, store, or capture knowledge. Always generate a concise summary and keyPoints — they are what makes knowledge searchable and reusable. Get spaceId from mcp_list_spaces. For personal knowledge, use the personal Space. Source is automatically set to \"llm\"."},{"name":"mcp_update_binding","description":"**Requires authentication.** Update a Binding's content by creating a new immutable Version. Use when the user wants to edit, correct, or add to existing knowledge. Old Versions are preserved — this never overwrites previous content. Fetch the current content first with mcp_get_binding (tier 2) before updating. Optionally update title and/or slug alongside the content."},{"name":"mcp_delete_binding","description":"**Requires authentication.** Delete a Binding and all its Versions permanently. Use when the user explicitly asks to delete or remove a knowledge item. This also removes the Binding from any Sets it was referenced in. Cannot be undone."},{"name":"mcp_search","description":"Search Bindings by keyword or phrase. **Works without auth** (returns public content only). With auth, searches all accessible Spaces including private ones. Use when the user asks to find, recall, or look up knowledge (\"do I have anything about X?\", \"find my notes on Y\"). Returns Tier 1 summaries with relevance scores. Follow up with mcp_get_binding (tier 2) to read full content. Optionally filter by spaceId to search within a specific Space."},{"name":"mcp_list_versions","description":"**Requires authentication.** List all Versions of a Binding in reverse chronological order. Use when the user wants to see revision history, compare versions, or find a specific historical version. Each Version in the response includes its versionId (UUID string) and version number. To add a specific Version to a Set, get the versionId from this response."},{"name":"mcp_get_version","description":"**Requires authentication.** Get a specific Version of a Binding by version number. Use when the user wants to read a particular historical snapshot (e.g. \"show me version 2\"). Use version number (integer), not versionId. Get available version numbers from mcp_list_versions. Same tier options as mcp_get_binding."},{"name":"mcp_list_sets","description":"**Requires authentication.** List Sets in a Space. Use to browse existing collections, or when the user asks \"what sets do I have?\". Returns set metadata including version count and total token count. Get spaceId from mcp_list_spaces."},{"name":"mcp_get_set","description":"**Requires authentication.** Get Set metadata and the list of Version references it contains. Use to inspect a Set's structure (name, description, version count, total tokens). Does NOT return Version content — use mcp_get_set_context to read the actual content. Get setId from mcp_list_sets."},{"name":"mcp_get_set_context","description":"**Requires authentication.** Retrieve the full content of all Versions in a Set, assembled within a token budget. Use this (not mcp_get_set) when you need to actually read Set contents — e.g. \"load my research set as context\". Versions are included in order until maxTokens is reached; response indicates if content was truncated. Use Tier 1 to fit more items, Tier 2 for deeper content on fewer items."},{"name":"mcp_create_set","description":"**Requires authentication.** Create a new Set (a named, ordered collection of specific Versions). Use when the user wants to group related knowledge together for later retrieval as a bundle. After creating, add Versions with mcp_add_version_to_set. Get spaceId from mcp_list_spaces."},{"name":"mcp_add_version_to_set","description":"**Requires authentication.** Add a specific Version of a Binding to a Set. A Set references Versions (not Bindings directly) so you pin a specific snapshot — future updates to the Binding do not affect the Set. versionId is a UUID string (NOT the version number). Get it from:   • mcp_get_binding response (the \"versionId\" field of the current version), or   • mcp_list_versions response (to add a historical version). Get setId from mcp_list_sets or from a mcp_create_set response."},{"name":"mcp_remove_version_from_set","description":"**Requires authentication.** Remove a Version from a Set. Use when the user wants to reorganize a Set by removing a specific item. The Version itself is not deleted — only the Set reference is removed."},{"name":"mcp_delete_set","description":"**Requires authentication.** Delete a Set. Use when the user wants to remove a collection entirely. Only the Set is deleted — the Bindings and Versions it referenced are NOT deleted."},{"name":"mcp_list_spaces","description":"List Spaces. **Works without auth** (returns public Spaces only). With auth, returns all accessible Spaces including your personal Space. Use this first to discover available Spaces and get spaceId values for other tools. Space types: personal (private, yours only), team (shared, public/private toggle), official (Bindly-curated, always public). Each Space response includes its ID, name, slug, type, and binding count."},{"name":"mcp_create_space","description":"**Requires authentication.** Create a new Team Space. Use when the user wants a new shared workspace separate from their personal Space. Team Spaces can be toggled public/private. Official Spaces are admin-panel-only. After creating, use mcp_create_binding with the new spaceId to add knowledge."},{"name":"mcp_create_share","description":"**Requires authentication.** Create a temporary share link for a Binding or Set. Use when the user wants to share content with someone who does not have Bindly access. Share links are not indexed by search engines and are only accessible via the direct URL. Returns a bind.ly/b/{id} (Binding) or bind.ly/s/{id} (Set) URL."},{"name":"mcp_list_shares","description":"**Requires authentication.** List existing share links. Use when the user wants to see or manage active share links for a Binding or Set. Filter by targetType and/or targetId to narrow results."},{"name":"mcp_delete_share","description":"**Requires authentication.** Revoke a share link immediately. Use when the user wants to deactivate a share link before it expires. The link becomes inaccessible instantly. Get shareId from mcp_list_shares."},{"name":"mcp_add_comment","description":"**Requires authentication.** Add a comment to a Binding, Version, or Set. Use to annotate knowledge with observations, corrections, caveats, or follow-up notes. Examples: flagging that data is outdated, noting a correction, adding context discovered later. Comment source is automatically set to \"llm\". targetType must match the ID you provide."},{"name":"mcp_list_comments","description":"**Requires authentication.** List comments on a Binding, Version, or Set. Use to retrieve annotations and notes left on a knowledge item. Comments include source (human/llm) and author information."},{"name":"mcp_delete_comment","description":"**Requires authentication.** Delete a comment you created. You can only delete your own comments. Get commentId from mcp_list_comments."},{"name":"mcp_recent_activity","description":"**Requires authentication.** View recent activity across your Spaces. Use when the user asks \"what have I been working on?\", \"show my recent changes\", or \"what was saved recently?\". Returns a chronological list of create/update/delete events."},{"name":"mcp_help","description":"Get help on using Bindly. Call with no topic for an overview of common workflows. Available topics: \"getting-started\", \"mcp/tools\", \"spaces\", \"bindings\", \"sets\", \"faq\"."},{"name":"check_connection","description":"Check Bindly MCP connection and authentication status. Returns whether you are logged in, which Spaces you can access, and what tools are available. Works without authentication. To log in, call connect()."},{"name":"connect","description":"**Log in to Bindly.** Call this to authenticate — your MCP client will open an OAuth login flow. If already authenticated, confirms the connection and shows your accessible Spaces. Call check_connection first to see current status."},{"name":"disconnect","description":"Log out of Bindly by revoking the current access token. Your saved data is not affected. To reconnect, call connect()."}],"connect":{"claudeCode":"claude mcp add --transport http bindly https://mcp.bind.ly/mcp","npm":"npx bindly-mcp","manual":"{ \"mcpServers\": { \"bindly\": { \"url\": \"https://mcp.bind.ly/mcp\" } } }"},"auth":"OAuth 2.0 — call connect() tool after connecting to authenticate","docs":"https://bind.ly/help/mcp"}