Gres API MCP Server

What is Gres API?

Gres API is an agentic endpoint layer built with FastAPI, offering modular tools, secure key authentication, and production-ready Docker deployment. It provides endpoints for snapping web pages, crawling sites or sitemaps, listing indexed sources, and querying a vector index via RAG (Retrieval-Augmented Generation).

How to use Gres API?

Set your API key in a .env file as VALGRESKY_API_KEY=sk_valgresky_yourkeyhere. The base URL is https://api.valgresky.com. Use the health check endpoint without authentication (/gres/health). All other endpoints require an X-API-Key header. Invoke endpoints like /gres/snap, /gres/grab, /gres/source, and /gres/ask with appropriate JSON payloads.

Key features of Gres API

• Health check endpoint without authentication
• Snap a page with /gres/snap
• Crawl a site or sitemap with /gres/grab
• List indexed sources via /gres/source
• Query vector index (RAG) with /gres/ask
• API key authentication for all non-health routes

Use cases of Gres API

• Capture a web page snapshot for archiving or analysis
• Index an entire website by crawling its sitemap
• Retrieve metadata about previously indexed sources
• Ask natural‑language questions against the indexed vector store
• Deploy as a containerized service with Docker Compose