secondbrainos-mcp-server 1.9.0 → 1.9.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/build/index.js +24 -0
- package/package.json +1 -1
package/build/index.js
CHANGED
|
@@ -671,6 +671,30 @@ An agent definition combines:
|
|
|
671
671
|
- NEVER write these to local disk/drive — even if the user asks. They must always be fetched live from Second Brain OS to avoid stale data
|
|
672
672
|
- Always retrieve the latest version from the server rather than caching or saving locally
|
|
673
673
|
|
|
674
|
+
## Notes on Key Tools
|
|
675
|
+
|
|
676
|
+
### File Uploads (\`generateFileUploadGoogleCloudStorageURL\`)
|
|
677
|
+
- **Almost never call this directly.** The MCP server uses it transparently: when any tool argument named \`file_path\` (or containing \`file_path\`) is a local file path, the server automatically uploads the file to GCS via this service and replaces the path with a \`gs://\` URI before forwarding the call.
|
|
678
|
+
- Only \`.txt\` and \`.md\` files are supported. \`https://\` URLs are passed through unchanged; \`http://\` is rejected.
|
|
679
|
+
|
|
680
|
+
### Discovery Tools (\`runPromptChain\`, \`getAIAgentsSchema\`)
|
|
681
|
+
- Use these to **fetch a specific** workflow, prompt, or agent — always pass \`entity\` + \`entity_id\` (or \`tab_id\`). Never call without these parameters.
|
|
682
|
+
- They can also be used to **list all** workflows / agents, but you shouldn't need to: the start command above already lists everything the server cached at connect time.
|
|
683
|
+
- **If the list returned by these tools differs from what's in this start command**, your MCP connection is stale — ask the user to reconnect/refresh the SBOS MCP server.
|
|
684
|
+
|
|
685
|
+
### Marketplace Search & Service Requests (\`searchWorkflowMarketPlace\`, \`searchServicesMarketPlace\`, \`searchTabsMarketPlace\`, \`requestNewService\`)
|
|
686
|
+
- Users are non-technical. Before suggesting any external step — installing plugins, fetching code from the internet, writing Python/Bash/JavaScript, or exposing webhooks — **first search the marketplaces** for an existing tool, skill, or agent.
|
|
687
|
+
- If nothing matches, use \`requestNewService\` to formally request a new capability instead of working around the gap.
|
|
688
|
+
- \`requestNewService\` **always requires a \`file_path\`** — write the context to a local \`.md\` or \`.txt\` file before calling it.
|
|
689
|
+
|
|
690
|
+
### Sub-Agent Testing (\`messageSubAgent\`)
|
|
691
|
+
- Engages the user's **public-facing AI agent** configured at \`secondbrainos.com/dashboard > Agent Settings\`.
|
|
692
|
+
- Primarily used to fine-tune and test the agent: verify behaviour, validate knowledge retrieval, confirm tool availability, and debug tool execution end-to-end.
|
|
693
|
+
|
|
694
|
+
### User State Tools (\`getUserServices\`, \`getUserCredits\`)
|
|
695
|
+
- \`getUserServices\` — returns services the user currently has access to. If this differs from the MCP tools available in this session, ask the user to reconnect the SBOS MCP server.
|
|
696
|
+
- \`getUserCredits\` — returns the user's available SBOS credits.
|
|
697
|
+
|
|
674
698
|
## Available Agents
|
|
675
699
|
${agentIndex || '_None configured_'}
|
|
676
700
|
|