# Grep Public API v2 MCP
> A cloud-hosted MCP server for starting and managing Grep research runs, reading generated files, managing attachments and agents, and checking quota and billing.
Canonical: https://www.mcpfolio.com/servers/grep-ai-mcp
Last updated: 2026-10-28
## Catalog record

- Publisher: Grep AI (Parcha, Inc.)
- Categories: search, marketing

## Website

https://grep.ai/developers/mcp

## Transports

Streamable HTTP

## Authentication

Browser-based OAuth 2.0. MCP clients discover the protected resource and authorization server from OAuth metadata. Claude Code and Codex use their documented mcp login flow; users complete sign-in in the browser. API keys are supported by the separate REST API, not substituted into this MCP recipe.

## Tools

- **run_create**: Start a Grep research run.
- **run_continue**: Continue a completed research run.
- **run_cancel**: Cancel an in-progress run.
- **run_list**: List research runs visible to the OAuth subject.
- **run_get**: Get a run report and state.
- **run_timeline**: List timeline events for a run.
- **run_files_list**: List files generated by a run.
- **run_file_read**: Read a generated research file.
- **attachment_create**: Upload one or more attachments.
- **attachment_get**: Inspect an attachment.
- **attachment_delete**: Delete an attachment.
- **quota_get**: Read current public API quota.
- **quota_check**: Check quota for a requested effort.
- **billing_usage_get**: Read billing usage.
- **agent_list**: List custom agents.
- **agent_create**: Create a custom agent.
- **agent_update**: Update an agent configuration.
- **agent_delete**: Archive a custom agent.
- **skills_list**: List or search skills.
- **skill_get**: Read skill content.
- **skill_create**: Create a custom skill.
- **mcp_tools_list**: List tools available for agent grants.
- **batch_create**: Create a batch of research runs.
- **batch_get**: Read batch status and progress.
- **campaign_create**: Create a campaign draft.
- **campaign_approve**: Approve and start paid campaign work.

## Sources

- [official_primary](https://grep.ai/developers/mcp)
- [official_primary](https://grep.ai/developers/api/auth)
- [official_live_server_card](https://api.grep.ai/.well-known/mcp/server-card.json)

## Setup

Use the interactive setup panel on [the detail page](https://www.mcpfolio.com/servers/grep-ai-mcp) to view instructions for each supported client.