Orama Search Engine Connector for AI agents.
3 live capabilities
Generate perfectly formatted JSON payloads for Orama search queries.
Waiting for input…
Why people use Orama Search Engine
Stop breaking Orama queries with the Orama Hybrid Search Query Builder
This MCP changes that by acting as a translator. You give it simple instructions, and it returns the exact structure Orama expects, making sure every query is valid.
What Vinkius changes
You stop debugging broken search syntax and start building functional queries.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Price Filtering
An engineer needs to find products under $50; the agent uses this MCP to build a 'lt' operator query automatically.
- Real-world use case 02
Date Range Queries
A developer wants to search for logs from the last 24 hours; the agent generates the correct timestamp comparison logic.
- Real-world use case 03
Category Filtering
A user asks for all sports gear; the agent builds an exact match equality query for the category field.
Complete set · 3capabilities
The complete Orama Search Engine capability set.
These are the exact actions your AI can choose when you ask it to work with Orama Search Engine.
01—03
3 capabilities in this set.
Part of 3 available through Orama Search Engine.
- 01 Capability
Get operator mapping summary
Shows you exactly how your filters map to Orama operators. Use this to see which rules apply to your data.
- 02 Capability
Validate filter syntax
Checks your filter dictionary for errors before you run a query. It prevents broken requests from hitting your engine.
- 03 Capability
Build orama query
Converts simple input into a nested JSON object for Orama searches. It handles all the complex hierarchy for you.
Set up in minutes
One URL. Then ask Orama Search Engine to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Orama Search Engine from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Orama Search Engine, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Orama Search Engine for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Orama Search Engine URL.
- Step 03
Save and start
Save the connection and enable Orama Search Engine in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"orama-hybrid-search-query-builder": {
"url": "https://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Orama Search Engine
Open Agent mode in chat and ask: "Using Orama Search Engine, help me...". 3 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"orama-hybrid-search-query-builder": {
"url": "https://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Orama Search Engine
Ask Copilot: "Using Orama Search Engine, help me...". 3 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"orama-hybrid-search-query-builder": {
"url": "https://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Orama Search Engine
Open Cascade and ask: "Using Orama Search Engine, help me...". 3 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"orama-hybrid-search-query-builder": {
"url": "https://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Orama Search Engine
Ask Cline: "Using Orama Search Engine, help me...". 3 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add orama-hybrid-search-query-builder --transport http "https://edge.vinkius.com/vk_preview_BQ7O5IoM6rjvkdusKaOa2Mt3EgaF6wXmj0IWNjuL/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Orama Search Engine
Ask Claude: "Using Orama Search Engine, show me...". 3 tools are ready
Where the request belongs
Work Orama Search Engine can move forward.
Developers and engineers managing Orama search indexes who need their agents to perform complex filtering without manual JSON construction.
Search Engineers
Building advanced, multi-attribute filtering logic for end-users.
Full-stack Developers
Integrating Orama search capabilities into applications via AI agents.
Backend Engineers
Automating the creation of complex search payloads within data pipelines.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsSwiftype
Connect your AI to Elastic Swiftype. Query your search engines, manage documents, and retrieve deep analytical insights natively from the terminal.
SerpApi
Equip your AI agent with real-time web search capabilities across Google, Bing, Baidu, Yahoo, and DuckDuckGo.
AddSearch
Equip your AI agent with AddSearch to query your indexed site content, push new documents, and retrieve search analytics instantly.
Elastic Enterprise Search
Manage enterprise search via Elastic. search engines and documents, handle indexing, and monitor search analytics directly from any AI agent.
Vertex AI Search
Search across your enterprise data using Google's semantic search and generative AI grounding.
Exa
Find exactly the web content you need with semantic search that understands context and returns high-quality curated results.
Bring your own AI
Change the model, client or framework. Keep Orama Search Engine connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Orama Search Engine.
The practical details behind the request, access and result.
How do I stop getting syntax errors in Orama?
Use the Oramah Hybrid Search Query Builder to generate payloads that are guaranteed to follow the correct JSON structure.
Can this MCP help with price range searches?
Yes, it transforms simple numeric filters into the proper 'lt' or 'gt' operators for your search engine.
Does the Orama Hybrid Search Query Builder work with any AI client?
It works with any compatible client like Claude, Cursor, or Windsurf connected via Vinkius.
How do I know if my filter dictionary is valid?
You can use the validation capability within this MCP to check your syntax before you ever send a query to Orama.
What kind of filtering is possible with this MCP?
It supports equality, greater than, and less than comparisons for any field in your index.
What is the main purpose of this MCP server?
It automates the creation of complex, nested JSON payloads for Orama search queries, ensuring syntactical correctness using build_orama_query.
How can I ensure my filter dictionary is valid?
You should use the validate_filter_syntax capability to check your dictionary for any unsupported types or invalid characters before attempting to build a query.
What operators are supported for filtering?
The server supports eq (equality), gt (greater than), and lt (less than) through its deterministic mapping logic.
One connection away
Give your agent a direct line to Orama Search Engine.
Connect Orama Search Engine once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available