Valstorm Hosted MCP Server (valstorm-mcp)
Stateless Streamable HTTP, SSE, and stdio Model Context Protocol (MCP) server exposing 16 granularly scoped Valstorm VFS, SQL, and CRM tools.
Connect Claude Desktop, Cursor, Windsurf, Hermes, or custom MCP clients directly to your Valstorm Knowledge Vaults and relational databases. Features OAuth 2.1 RFC 9728/8414 discovery, stateless multi-replica HTTP transport, S3 presigned binary transfer recipes, and single-roundtrip foreign-key hydration.
1. Run via Local stdio or Stateless Streamable HTTP (/mcp)
# 1. Run locally over stdio (for Claude Desktop / Cursor local config)
uv run valstorm-mcp --transport stdio
# 2. Run stateless Streamable HTTP + SSE server on port 8660
uv run valstorm-mcp --transport streamable-http --host 0.0.0.0 --port 8660
# 3. Example MCP Tool Call: Execute Valstorm SQL with ME keyword
# Tool: record_query_sql
{
"query": "SELECT id, name, status FROM deal WHERE owner = ME ORDER BY created_date DESC LIMIT 10"
}
2. How valstorm-mcp Works Under the Hood
🤖 Claude Desktop / Cursor / AI IDE / Autonomous Agent
│
┌──────────────────┼──────────────────┐
▼ (/mcp HTTP) ▼ (/sse) ▼ (stdio)
⚡ Valstorm MCP Server (Stateless Proxy + OAuth 2.1 Discovery)
• Enforces Scopes: vfs:read/write, record:read/write, query:execute
• 16 Tools: vfs_search, vfs_ask (RAG), record_query_sql, record_hydrate_batch
• Offloads binary uploads/downloads via Presigned S3 Recipes
│
▼
☁️ Valstorm Core API & OpenSearch Hybrid Vector Engine 3. Core Capabilities & Technical Specifications
Hybrid Vector Search & Server-Side Gemini RAG
Exposes vfs_search (dense vector + metadata chunk retrieval) and vfs_ask (synthesized RAG answers with citations) across your private Knowledge Vaults.
Full SQL & Mongo Aggregation Engine
Run Valstorm SQL queries (with dynamic dates like last_n_days:7 and owner = ME) or raw MongoDB aggregation pipelines directly from your AI IDE.
Out-of-Band S3 Binary Transfer Orchestrator
Prevents JSON-RPC context window bloat on large files by returning presigned S3 upload/download URLs and terminal execution recipes.
Granular Token Scope Enforcement
Every tool call validates token scopes (vfs:read, vfs:write, record:read, record:write, query:execute) before proxying to the core API.
4. Open-Source & Commercial Licensing
PolyForm Noncommercial License 1.0.0
Free to clone, inspect, modify, and run for personal projects, educational study, and noncommercial research under the PolyForm Noncommercial License 1.0.0.
Valstorm Commercial License
Commercial use in business operations is included automatically with any active Valstorm BOS workspace ($25/mo in usage credits with $0/seat tax) or available via enterprise BYOC licensing.
5. Frequently Asked Questions
Which transports does valstorm-mcp support?
valstorm-mcp supports the modern stateless Streamable HTTP transport at /mcp, legacy SSE at /sse + /messages, and local stdio for desktop IDE integrations.
Explore Other Valstorm Open-Source Packages
View All 7 Tools →Enterprise-grade autonomous AI execution runtime, ReAct loop, and parallel subagent swarm engine for developer workstations, CI pipelines, and remote team automation.
Command-line interface for Valstorm developers to authenticate via OAuth2 PKCE, pull and push object schemas as code, and manage local workspaces.
High-performance web scraping, domain crawling, RSS monitoring, and visual diff microservice with Python 3.14 native Zstandard compression.
Dedicated asynchronous microservice for multi-preset FFmpeg video transcoding, Deepgram/Whisper speech-to-text captions, and AI chapter generation.
Official typed Python 3.13+ SDK with 1:1 PlatformContext parity across records, SQL/GraphQL queries, VFS Knowledge Vaults, schemas, and sandboxes.
Pure Python standard-library secret redaction engine that strips API keys, JWTs, database passwords, and environment secrets before logs or LLM prompts egress.