agent-skills

This MCP server implements the ParadeDB Agent Skill, which provides Elasticsearch-quality full-text search capabilities for PostgreSQL by fetching ParadeDB documentation in real time. The skill uses a pointer-based approach: instead of bundling static docs that can become stale, it instructs MCP-enabled agents to retrieve the latest ParadeDB guidance from the official docs (https://docs.paradedb.com/llms-full.txt) as needed during conversations. When you ask about ParadeDB concepts such as BM25 indexing, full-text search in Postgres, or ParadeDB-specific workflows, the MCP server guides the agent to pull the most up-to-date information and respond with accurate guidance. The README also notes that ParadeDB documentation is available directly for MCP integration at https://docs.paradedb.com/mcp, making it easy to integrate with MCP-compatible agents.

Once installed, the skill activates automatically when you reference ParadeDB in prompts. It can answer questions about indexing strategies, recommended configurations for text search, and how ParadeDB compares to Elasticsearch or other search solutions within PostgreSQL. If your workflow relies on up-to-date documentation, this MCP server ensures responses are backed by the latest ParadeDB material rather than a static snapshot.

Prerequisites:

• Node.js and npm (or corepkgs for your environment) installed on your system.
• Internet access to fetch the MCP server package from the npm registry via npx.

Install the MCP server (one-line method):

npx skills add paradedb/agent-skills

Alternative approach (if you prefer a local installation flow):

# Ensure npm is up to date
npm install -g npm

# Confirm npx is available and then install the skill via npx format
npx skills add paradedb/agent-skills

Test the installation by invoking the MCP server through your MCP client or by running a small test prompt that references ParadeDB in your agent workflow.

Notes and tips:

• The skill fetches real-time ParadeDB documentation. If the docs URL changes, the MCP server will still route requests to the current source as long as the underlying pointer remains valid.
• If you need to customize how the agent surfaces guidance, you can tailor prompts in your MCP client to emphasize ParadeDB topics (BM25 indexing, full-text search in Postgres, alternatives to Elasticsearch).
• In environments with restricted network egress, ensure the host can resolve and fetch content from docs.paradedb.com and the MCP endpoints.
• If you encounter version conflicts with npx or the skill installer, try updating npm or using a node version manager to switch Node versions.
• There is an MCP-specific entry point at https://docs.paradedb.com/mcp for direct MCP integration plans and examples.