Can my agent trigger a new web crawl in Grepsr?

Yes. Use the 'run_report' tool. By providing the Report ID, the agent can programmatically trigger an on-demand crawl, starting the data extraction process immediately flawlessly.

How do I retrieve the actual scraped data records via chat?

You can use the 'get_report_data' or 'get_latest_data' tools. Your agent will fetch the structured records from Grepsr's database and present them in a readable format within your chat interface flawlessly.

Can I check my API usage limits through the agent?

Absolutely. Use the 'get_usage_stats' tool. Your agent will retrieve your current plan limits and remaining API credits, helping you manage your data extraction budget flawlessly.

Grepsr MCP Server for Pydantic AI 12 tools — connect in under 2 minutes

Name: Grepsr
Availability: InStock
Author: Vinkius

ai.pydantic.dev/mcp

Built by Vinkius GDPR 12 Tools SDK

Pydantic AI brings type-safe agent development to Python with first-class MCP support. Connect Grepsr through Vinkius and every tool is automatically validated against Pydantic schemas. catch errors at build time, not in production.

Get MCP Server for AI Agents

ASK AI ABOUT THIS MCP SERVER

Open in ChatGPT Open in Claude Open in Perplexity

Vinkius supports streamable HTTP and SSE.

python

import asyncio
from pydantic_ai import Agent
from pydantic_ai.mcp import MCPServerHTTP

async def main():
    # Your Vinkius token. get it at cloud.vinkius.com
    server = MCPServerHTTP(url="https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp")

    agent = Agent(
        model="openai:gpt-4o",
        mcp_servers=[server],
        system_prompt=(
            "You are an assistant with access to Grepsr "
            "(12 tools)."
        ),
    )

    result = await agent.run(
        "What tools are available in Grepsr?"
    )
    print(result.data)

asyncio.run(main())

Fully ManagedVinkius Servers

60%Token savings

High SecurityEnterprise-grade

IAMAccess control

EU AI ActCompliant

DLPData protection

V8 IsolateSandboxed

Ed25519Audit chain

<40msKill switch

Stream every event to Splunk, Datadog, or your own webhook in real-time

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure

About Grepsr MCP Server

Connect your Grepsr account to any AI agent and take full control of your managed web scraping operations. Use natural language to trigger on-demand crawls, monitor data delivery schedules, and retrieve structured datasets directly into your workflow.

Pydantic AI validates every Grepsr tool response against typed schemas, catching data inconsistencies at build time. Connect 12 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.

What you can do

Report Orchestration — List all your reports and crawlers and retrieve specific configuration details natively
Live Data Retrieval — Query and resolve structured records from specific reports or run histories flawlessly
On-Demand Crawling — Trigger manual crawl runs for any report to refresh your datasets synchronously
Execution Monitoring — Track the status and record counts of crawl histories to audit data quality flawlessly
Webhook Management — Setup and audit webhooks to notify your internal systems as soon as new data is ready natively
Integration Visibility — List active data delivery integrations including S3, SFTP, and cloud storage providers synchronously

The Grepsr MCP Server exposes 12 tools through the Vinkius. Connect it to Pydantic AI in under two minutes — no API keys to rotate, no infrastructure to provision, no vendor lock-in. Your configuration, your data, your control.

How to Connect Grepsr to Pydantic AI via MCP

Follow these steps to integrate the Grepsr MCP Server with Pydantic AI.

Install Pydantic AI

Run pip install pydantic-ai

Replace the token

Replace [YOUR_TOKEN_HERE] with your Vinkius token

Run the agent

Save to agent.py and run: python agent.py

Explore tools

The agent discovers 12 tools from Grepsr with type-safe schemas

Why Use Pydantic AI with the Grepsr MCP Server

Pydantic AI provides unique advantages when paired with Grepsr through the Model Context Protocol.

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 Grepsr integration code

Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors

Dependency injection system cleanly separates your Grepsr connection logic from agent behavior for testable, maintainable code

Grepsr + Pydantic AI Use Cases

Practical scenarios where Pydantic AI combined with the Grepsr MCP Server delivers measurable value.

Type-safe data pipelines: query Grepsr with guaranteed response schemas, feeding validated data into downstream processing

API orchestration: chain multiple Grepsr tool calls with Pydantic validation at each step to ensure data integrity end-to-end

Production monitoring: build validated alert agents that query Grepsr and output structured, schema-compliant notifications

Testing and QA: use Pydantic AI's dependency injection to mock Grepsr responses and write comprehensive agent tests

Grepsr MCP Tools for Pydantic AI (12)

These 12 tools become available when you connect Grepsr to Pydantic AI via MCP:

create_webhook

Configure a new webhook URL for a report

get_latest_data

Retrieve the most recent scraped dataset for a report

get_me

Get details for the current Grepsr account

get_report_data

Query scraped records from a specific report

get_report_details

Get metadata and configuration for a specific report

get_report_history

Retrieve the execution history (runs) for a specific report

get_usage_stats

Check account API usage and request limits

list_integrations

List active data delivery integrations (e.g. S3, SFTP)

list_projects

List all scraping projects

list_reports

List all reports and crawlers in your Grepsr account

list_webhooks

List webhooks configured for a specific report

run_report

Trigger an on-demand crawl for a specific report

Example Prompts for Grepsr in Pydantic AI

Ready-to-use prompts you can give your Pydantic AI agent to start working with Grepsr immediately.

"List my web scraping reports in Grepsr"

"Trigger a manual crawl for report ID 104"

"Show me the 5 most recent records from the 'Real Estate Listings' report"

Troubleshooting Grepsr MCP Server with Pydantic AI

Common issues when connecting Grepsr to Pydantic AI through the Vinkius, and how to resolve them.

MCPServerHTTP not found

Update: pip install --upgrade pydantic-ai

Grepsr + Pydantic AI FAQ

Common questions about integrating Grepsr MCP Server with Pydantic AI.

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 Grepsr MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.