Connect your applications to Ragger with our comprehensive guides
Automated registration and onboarding - get your account instantly
Send a WhatsApp message with the word "ragger" to our automated registration system. The system will automatically create your account, manage your registration, and handle onboarding.
Send WhatsApp MessageSend an email to our automated registration system. The system will automatically create your account and respond with your credentials and API endpoint.
Send EmailBoth WhatsApp and email registration are fully automated. The system will instantly create your account, manage your registration, handle onboarding, and respond with your API endpoint URL and account credentials. No manual intervention required!
Need help? Contact sales at sales.ragger@1nga.com
Simple steps to connect your website to Ragger without writing code
After subscribing to Ragger, you'll receive your API endpoint URL. For hosted service users, this will be provided upon account setup. It will look something like:
Save this URL—you'll need it for the next steps. Note: Self-hosted deployment is available for subscribers and enterprise customers. Contact us at sales.ragger@1nga.com for self-hosting options.
Create a file named rager.json in your website's root directory. This file tells Ragger which pages to index.
{
"$schema": "https://rager.1nga.com/schema/v1",
"version": "1.0.0",
"siteId": "your-unique-site-id",
"name": "Your Website Name",
"description": "Description of your website",
"endpoints": [
{
"path": "/docs",
"type": "markdown",
"title": "Documentation"
},
{
"path": "/about",
"type": "html",
"title": "About Page"
}
],
"settings": {
"autoUpdate": true,
"updateInterval": "24h"
}
}Replace your-unique-site-id with a unique identifier for your site, and add the pages you want to make searchable in the endpoints array.
Share your rager.json file and your website URL with your development team. They will process it through Ragger's API to make your content searchable.
Once processed, your website content will be indexed and ready for intelligent search queries.
Technical integration guide for connecting applications to Ragger
All API requests should be made to your Ragger hosted service endpoint (provided upon subscription):
Self-Hosting Available: Subscribers and enterprise customers can deploy Ragger on their own infrastructure. Contact us at sales.ragger@1nga.com to discuss self-hosting options and requirements.
Submit a website's rager.json configuration to index all content:
POST /api/rager/process
Content-Type: application/json
{
"rager_json": {
"$schema": "https://rager.1nga.com/schema/v1",
"version": "1.0.0",
"siteId": "site-123",
"name": "My Website",
"endpoints": [
{"path": "/docs", "type": "markdown"},
{"path": "/api-docs", "type": "openapi"}
]
},
"base_url": "https://example.com"
}This will automatically extract content from all specified endpoints and make them searchable.
Add individual documents to the vector store:
POST /api/documents
Content-Type: application/json
{
"content": "Your document content here...",
"metadata": {
"title": "Document Title",
"source": "https://example.com/page"
}
}Search for relevant documents using semantic search:
POST /api/documents/search
Content-Type: application/json
{
"query": "What is your question?",
"k": 5
}Returns the top k most relevant documents based on semantic similarity.
Get AI-generated answers based on your documents:
POST /api/rag/query
Content-Type: application/json
{
"query": "Explain how authentication works",
"k": 4
}This endpoint retrieves relevant documents and generates a contextual answer using AI.
Verify your connection to Ragger:
GET /healthConnect Ragger to Model Context Protocol (MCP) servers for AI assistant integration
Model Context Protocol (MCP) is a standard for connecting AI assistants to external data sources and tools. By integrating Ragger with MCP, you can enable AI assistants to search and retrieve information from your documents.
Create an MCP server configuration file to connect your AI assistant to Ragger:
{
"mcpServers": {
"ragger": {
"command": "npx",
"args": [
"-y",
"@modelcontextprotocol/server-ragger",
"--api-url",
"https://your-ragger-instance.com"
]
}
}
}Replace https://your-ragger-instance.com with your Ragger hosted service endpoint (provided upon subscription). For self-hosted deployments, use your self-hosted instance URL.
Once configured, your MCP server will expose the following resources:
ragger://documents List all indexed documents
ragger://search Search documents by query
ragger://query Perform RAG queries for AI-generated answers
After configuration, your AI assistant can:
Once configured, you can ask your AI assistant: "Search my documentation for authentication methods" and it will query Ragger to find relevant information from your indexed documents.
All available endpoints for programmatic access
GET /health Check API health statusGET / Get API information and available endpointsPOST /api/documents Add a document to the vector storeGET /api/documents List all documentsGET /api/documents/:id Get a specific documentDELETE /api/documents/:id Delete a documentPOST /api/documents/search Search for similar documentsPOST /api/rag/query Perform RAG query with AI-generated answersGET /api/rag/stats Get vector store statisticsPOST /api/rager/process Process rager.json configuration filePOST /api/rager/validate Validate rager.json file formatDeploy Ragger on your own infrastructure for maximum control
Self-hosted deployment is available for subscribers and enterprise customers who require complete infrastructure control and data sovereignty.
Contact our sales team at sales.ragger@1nga.com to discuss self-hosting requirements, infrastructure needs, and deployment options. We'll help you get Ragger running on your infrastructure with full support.
If you need assistance with integration, have questions about connecting your application, or want to discuss self-hosting options, we're here to help.
Contact Sales & Support