Scrapbox Cosense MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| API_DOMAIN | No | API domain | scrapbox.io |
| COSENSE_SID | No | Session ID for Scrapbox/Cosense authentication (required for private projects) | |
| SERVICE_LABEL | No | Service identifier | cosense (scrapbox) |
| COSENSE_PAGE_LIMIT | No | Initial page fetch limit (1-1000) | 100 |
| COSENSE_SORT_METHOD | No | Initial page fetch order (updated/created/accessed/linked/views/title) | updated |
| COSENSE_PROJECT_NAME | Yes | Project name |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {} |
| prompts | {} |
| resources | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| create_pageA | Create a new page in Scrapbox project on cosense (scrapbox). Creates a new page with the specified title and optional body text. Returns the page creation URL without opening browser. Uses my-cosense-project project as default if projectName is not specified. |
| get_page_urlA | Generate URL for a page in Scrapbox project on cosense (scrapbox). Returns the direct URL to the specified page without opening it in browser. Uses my-cosense-project project as default if projectName is not specified. |
| get_pageB | Get a page from Scrapbox project on cosense (scrapbox). Returns page content and its linked pages. Page content includes title and description in plain text format. Uses my-cosense-project project as default if projectName is not specified. |
| list_pagesA | Browse and list pages from Scrapbox project on cosense (scrapbox) with flexible sorting and pagination. Use this tool to discover pages by recency, popularity, or alphabetically. Returns page metadata and first 5 lines of content. Available sorting methods: updated (last update time), created (creation time), accessed (access time), linked (number of incoming links), views (view count), title (alphabetical). Different from search_pages which finds content by keywords. Uses my-cosense-project project as default if projectName is not specified. |
| search_pagesA | Search for content within pages in Scrapbox project on cosense (scrapbox). Use this tool to find pages containing specific keywords or phrases. Returns matching pages with highlighted search terms and content snippets. Limited to 100 results maximum. Supports basic search ("keyword"), multiple keywords ("word1 word2" for AND search), exclude words ("word1 -word2"), and exact phrases (""exact phrase""). Different from list_pages which browses pages by metadata. Uses my-cosense-project project as default if projectName is not specified. |
| get_smart_contextA | Get smart context for a page on cosense (scrapbox). Returns the target page and its linked pages (1-hop or 2-hop) with full content in AI-optimized format. Useful for understanding the context and related knowledge around a specific topic. Requires COSENSE_SID authentication. Uses my-cosense-project project as default if projectName is not specified. |
| insert_linesA | Insert text after a specified line in a Scrapbox page on cosense (scrapbox). If target line not found, text is appended to the end of the page. Uses my-cosense-project project as default if projectName is not specified. |
| edit_linesA | Replace one or more lines in a Scrapbox page on cosense (scrapbox). Matches the target by exact text and substitutes it with new content (which may span multiple lines). If targetLineText contains newline characters, it is matched as a contiguous block of lines, so any n lines can be replaced with m lines. By default only the first match is replaced; set matchAll to replace every (non-overlapping) occurrence. Returns an error if no match is found. Requires COSENSE_SID. Uses my-cosense-project project as default if projectName is not specified. |
| delete_linesA | Delete one or more lines from a Scrapbox page on cosense (scrapbox). Matches the target by exact text. If targetLineText contains newline characters, it is matched as a contiguous block of lines and removed as a whole. By default only the first match is removed; set matchAll to remove every (non-overlapping) occurrence. Refuses to delete the title line (the first line), which would rename or remove the page — use delete_page for that. Returns an error if no match is found. Requires COSENSE_SID. Uses my-cosense-project project as default if projectName is not specified. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Each tool has a clearly distinct purpose: search_pages for keyword search, list_pages for metadata browsing, get_page for content retrieval, get_page_url for URL generation, get_smart_context for context expansion, and separate create/edit/insert/delete operations for lines. No two tools overlap in functionality.
All tool names follow a consistent snake_case verb_noun pattern (search_pages, create_page, list_pages, insert_lines, edit_lines, delete_lines). The verbs are intuitive and match the actions, making the set predictable.
With 9 tools, the server is well-scoped for managing Scrapbox pages and lines. Each tool serves a distinct function, and the count is within the ideal 3-15 range, balancing coverage without redundancy.
The set covers create, read, and line-level update/delete, but omits a delete_page tool even though the delete_lines description references it. This missing operation breaks the page lifecycle and forces agents to use unsupported calls, causing failures. Additionally, there is no tool to rename or update page metadata.