Bring Rag
to Pydantic AI
Create your Vinkius account to connect Verba to Pydantic AI and start using all 6 AI tools in minutes. Fully managed, enterprise secure, and ready to use without writing a single line of code. No hosting, no server setup — just connect and start using.
Compatible with every major AI agent and IDE
What is the Verba MCP Server?
Intertwine the open-source Verba (by Weaviate) ecosystem natively into your conversational AI IDE. Execute powerful Retrieval-Augmented Generation processes and manage your localized knowledge bases simply by chatting.
What you can do
- Augmented Queries — Cast a question to your agent and have it retrieve fully synthesized answers from the Verba engine completely backed up by exact document citations.
- Knowledge Management — Insert new context text, list all ingested documents, retrieve the deeply embedded raw data of any ID, or remove dead knowledge dynamically without Web UIs.
- Health Checks — Request system configurations directly via chat to ensure your local LLM connections, embedding models, and cluster health are firing effectively.
How it works
- Ensure your local or cloud Verba instance is running
- Supply your Verba API URL and API Key (if authenticated)
- Ask Claude or Cursor to query, retrieve, or insert document structures intuitively.
Who is this for?
- RAG Developers — quickly add or delete text chunks to evaluate changes in embedding fidelity directly inside your IDE coding session.
- Knowledge Managers — query your dense technical manuals using semantic search and receive the verified text snippets instantly.
- Open Source Hobbyists — orchestrate your personal Weaviate/Verba RAG stacks strictly through the programmatic conversational layer.
Built-in capabilities (6)
Provide the document content and optional metadata JSON. Ingests a new document into the Verba knowledge base
This action is irreversible. Permanently removes a document from the knowledge base
Retrieves the full content and metadata of a specific document
Retrieves the current Verba system configuration
Lists all documents indexed in the Verba knowledge base
Returns summarized answers with citations. Executes a RAG (Retrieval Augmented Generation) query against the Verba knowledge base
Why Pydantic AI?
Pydantic AI validates every Verba tool response against typed schemas, catching data inconsistencies at build time. Connect 6 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Verba integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your Verba connection logic from agent behavior for testable, maintainable code
Verba in Pydantic AI
Why run Verba with Vinkius?
The Verba connection runs on our fully managed, secure cloud infrastructure. We handle the hosting, maintenance, and security so you don't have to deal with servers or code. All 6 tools are ready to work instantly without any complex setup.
You stay in complete control of your data. Your AI only accesses the information you approve, keeping your sensitive passwords and private details completely safe. Plus, with automatic optimizations, your AI works faster and more efficiently.

* Every connection is hosted and maintained by Vinkius. We handle the security, updates, and infrastructure so you don't have to write code or manage servers. See our infrastructure
Over 4,000 integrations ready for AI agents
Explore a vast library of pre-built integrations, optimized and ready to deploy.
Connect securely in under 30 seconds
Generate tokens to authenticate and link external services in a single step.
Complete visibility into every agent action
Audit live requests, latency, success rates, and active security compliance policies.
Optimize spending and track token ROI
Analyze real-time token consumption and cost metrics detailed by connection.




Explore our live AI Agents Analytics dashboard to see it all working
This dashboard is included when you connect Verba using Vinkius. You will never be left in the dark about what your AI agents are doing with your tools.
Verba and 4,000+ other AI tools. No hosting, no code, ready to use.
Professionals who connect Verba to Pydantic AI through Vinkius don't need to write code, manage servers, or worry about security. Everything is pre-configured, secure, and runs automatically in the background.
Raw MCP | Vinkius | |
|---|---|---|
| Ready-to-use MCPs | Find and configure each manually | 4,000+ MCPs ready to use |
| Connection Setup | Manual coding & server setup | 1-click instant connection |
| Server Hosting | You host it yourself (needs 24/7 uptime) | 100% hosted & managed by Vinkius |
| Security & Privacy | Stored in plaintext config files | Bank-grade encrypted vault |
| Activity Visibility | Blind execution (no logs or tracking) | Live dashboard with real-time logs |
| Cost Control | Runaway AI token spend risk | Automatic budget limits |
| Revoking Access | Must delete files or code to stop | 1-click disconnect button |
How Vinkius secures
Verba for Pydantic AI
Every request between Pydantic AI and Verba is protected by our secure gateway. We automatically keep your sensitive data private, prevent unauthorized access, and let you disconnect instantly at any time.
Frequently asked questions
Can I query my local Verba instance directly through Cursor?
Yes! Once you configure VERBA_API_URL to point to http://localhost:8000 (or your host port), you can prompt your AI assistant to execute rigorous perform_rag_query instructions without ever breaking your developer focus.
How do I insert fresh text data into Verba completely using conversational chat?
Provide the agent with your desired context directly. For example: Add this chunk of markdown as a new document to Verba: '# Title Content...'. The agent leverages addDocumentTool, serializes the payload, and commits it into Verba's vector store immutably.
Are the query answers backed by citations from its embedded documents?
Absolutely. That's the primary benefit of the integration. When you run perform_rag_query, Verba utilizes Weaviate's hybrid search mechanics. The output explicitly includes natural language synthesis backed by the unique document IDs and snippet texts it referenced.
How does Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your Verba MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Explore More MCP Servers
View all →
Kissmetrics
7 toolsTrack user behavior, set properties, and query analytics data via the Kissmetrics API.

Peerbie
16 toolsOrchestrate your entire team's workspace, from Kanban boards to calendar events, completely driven by AI.

Dalil AI
6 toolsBuild AI assistants that understand Arabic natively and serve Middle Eastern markets with culturally aware conversational AI.

DoorLoop
12 toolsManage rental properties, collect rent online, screen tenants, and handle maintenance requests from one landlord platform.
