Meilisearch v1.0
Community OpenAPI document · agent-readyAI/MLEmbeddings SearchapiKey65 EndpointsREST
Know of an official OpenAPI document? Contribute it →
For Agents
Create and configure search indexes, add and update documents, and run fast full-text search with typo tolerance, filtering, and faceting on a self-hosted Meilisearch instance. Manage index settings, API keys, and asynchronous tasks. Returns ranked search hits and task status.
Use for: I need to create a search index for my documents, Add a batch of documents to an index, Run a full-text search over my indexed data, Configure which attributes are searchable and displayed
Not supported: Provides full-text search, indexing, and index configuration on a self-hosted instance; does not host a language-model or chat endpoint or manage hosting and billing through this surface. Use for search and indexing.
Meilisearch is a self-hosted search engine you run on your own instance. This API creates and configures indexes, adds and updates documents, and runs fast full-text search with typo tolerance, filtering, faceting, and custom ranking rules. It exposes fine-grained index settings such as searchable and displayed attributes, synonyms, stop-words, and sortable attributes, manages API keys, and tracks the asynchronous tasks that document and settings changes create.
Install Jentic One Beta
Connect the Meilisearch v1.0 to your agent
Jentic One is a self-hosted execution layer for AI agents. It lets your agent call the Meilisearch v1.0, or any other public or private API you need. You set the rules, the agent never sees your credentials, and every call is logged.
Two steps, two machines. Install the instance in a safe environment, then register your agent from wherever it runs.
1
Step 1: Jentic One Host machine
# On the machine that will host your Jentic One instance:
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmeilisearch.com%2Fmeilisearch-v1-0" | sh2
Step 2: Agent machine
# On the machine where your agent runs (keep this separate from the instance):
curl -fsSL "https://jentic.com/install.sh?src=apis&api=%2Fapis%2Fmeilisearch.com%2Fmeilisearch-v1-0" | sh
jentic register # connects your agent to your Jentic One instanceJentic One is in public beta. The setup above keeps your agent separate from the instance, which is what you want before using real credentials: an agent running as the same OS user as Jentic One can read its stored keys directly. Just evaluating? A single local install is fine to start. See the secure deployment guide for the tiers.
Capabilities
What an agent can do with Meilisearch v1.0 API.
Create, list, update, and delete search indexes
Add, replace, update, and delete documents in an index
Run full-text search with typo tolerance, filtering, and faceting
Configure index settings such as searchable attributes, synonyms, and ranking rules
Create, list, update, and delete API keys with scoped permissions
Track the asynchronous tasks that document and settings changes create
Use Cases
Patterns agents use Meilisearch v1.0 API for, with concrete tasks.
★ Search backend for an AI agent
Give an AI agent a search layer it can populate and query on a Meilisearch instance you run yourself. Through Jentic the agent discovers the index, document, and search operations by intent and calls them with a validated input schema, so an assistant can index a corpus and then run full-text search to fetch the most relevant records for a question, with typo tolerance handling imperfect queries.
Create an index, add a batch of help articles as documents, then run a full-text search for a user's question and return the top three hits
Site and app search
Power an instant search experience for a website or application, returning ranked hits with typo tolerance, filtering, and faceting. You configure searchable attributes, synonyms, and ranking rules so results match how your users actually query, and the search endpoint returns results fast enough for as-you-type interfaces.
Search the products index for 'wireles headphnes' and return the corrected, ranked results using typo tolerance
Index configuration and content sync
Keep an index aligned with a source of truth by adding, updating, and deleting documents, and tune relevance through index settings such as searchable attributes, synonyms, stop-words, and ranking rules. Because changes are asynchronous, you can track each task to confirm when an update has been applied.
Update the synonyms setting on the products index and then check the resulting task until it reports success
Scoped access with API keys
Create and manage API keys with scoped permissions so different clients get only the access they need, such as a search-only key for a public front end and an admin key for indexing. Listing and updating keys lets you rotate and audit access to your Meilisearch instance.
Create a search-only API key restricted to the products index for use in a public web front end
Key Endpoints
65 endpoints — meilisearch is a self-hosted search engine you run on your own instance.
METHOD
PATH
DESCRIPTION
POST
/indexes
Create an index
GET
/indexes
List indexes
POST
/indexes/books/documents
Add or replace documents in an index (books is the spec's example index)
POST
/indexes/books/search
Search documents in an index (books is the spec's example index)
GET
/tasks
List asynchronous tasks
GET
/keys
List API keys
POST
/indexes
Create an index
GET
/indexes
List indexes
POST
/indexes/books/documents
Add or replace documents in an index (books is the spec's example index)
POST
/indexes/books/search
Search documents in an index (books is the spec's example index)
GET
/tasks
List asynchronous tasks
GET
/keys
List API keys
Why Jentic?
What agents get from Jentic-routed access to this vendor.
Setup
Wiring Meilisearch by hand means pointing at your own instance, sending the API key as a bearer token on every request, and tracking the asynchronous task each change returns. Through Jentic you install once, import Meilisearch from the API Directory, store the key once, and your agent calls the index, document, and search operations directly.
Permission scoping
You choose the operations your agent may call, so you can allow searching and reading documents while withholding index and document deletion or key management. That way a search assistant can query your instance without the ability to destroy indexes or mint new keys.
Credential isolation
Your Meilisearch API key is stored once, encrypted, by your own Jentic One instance and injected at execution time. It never enters the agent's prompt, logs, or context, and because the instance is self-hosted your search data stays on infrastructure you control.
Intent-based discovery
Agents search Jentic by intent such as 'run a full-text search' or 'add documents to an index', and Jentic returns the matching Meilisearch operation with its input schema so the agent calls the right endpoint without reading the reference docs.
Related APIs
Alternatives and complements available in the Jentic catalogue.
FAQs
Specific to using Meilisearch v1.0 API through Jentic.
What authentication does the Meilisearch API use?
Meilisearch authenticates with an API key sent as a bearer token in the Authorization header. You manage keys through the keys endpoints, creating scoped keys for search-only or admin access. Through Jentic the key is stored once and injected at call time, so your agent never places it in a header itself.
Is Meilisearch self-hosted, and what does that mean for my agent?
Yes. Meilisearch runs on your own instance rather than a shared cloud endpoint, so your documents and search traffic stay on infrastructure you control. Through Jentic your agent points at your instance and calls the index, document, and search operations without exposing the instance or its key in the prompt.
Is there a Meilisearch MCP server?
You do not need an MCP server to give your agent Meilisearch. Jentic connects it directly from the API Directory: import it, store your API key once, and your agent calls the index, document, and search operations on demand. Nothing extra runs, and no server tool definitions sit in the agent's context between calls.
Can I limit what my agent is allowed to do with Meilisearch?
Yes. Write a rule that allows only the operations you need, such as running searches while leaving out index and document deletion, so the agent can query your data but cannot destroy it. Every call it makes is logged, so you can audit exactly which operations ran.
What are the rate limits for Meilisearch?
Because Meilisearch is self-hosted, there is no vendor-imposed rate limit. Throughput is bounded only by the resources of the instance you run it on, so you scale it to your own workload rather than a plan tier.
How do I run a search with Meilisearch through Jentic?
Search Jentic for 'run a full-text search' to find the search operation, which returns ranked hits from an index with typo tolerance, and pair it with the add-documents operation to populate the index first. Jentic returns each operation with its input schema so your agent calls it correctly. To run it on your own infrastructure, install Jentic One from its GitHub repo.
GET STARTED