# DevRev Python SDK & MCP Server

> Built with [Augment Code](https://www.augmentcode.com/) — A modern, type-safe Python SDK and MCP Server for the DevRev API. Provides both a programmatic SDK (sync/async) and an AI-accessible MCP server with 78+ tools, 7 resources, and 8 prompts.

Key information:
- Python 3.11+ required
- Install SDK: `pip install devrev-python-sdk`
- Install with MCP: `pip install devrev-python-sdk[mcp]`
- Authentication via DEVREV_API_TOKEN environment variable
- Both sync and async clients available (DevRevClient, AsyncDevRevClient)
- Uses Pydantic v2 for all request/response models
- MCP Server command: `devrev-mcp-server`
- Version 2.10.1 (current)

## SDK Quick Start

- [Installation](docs/getting-started/installation.md): Setup instructions and requirements
- [Authentication](docs/getting-started/authentication.md): API token configuration
- [Quick Start](docs/getting-started/quickstart.md): First API calls and basic patterns

## MCP Server

- [MCP Overview](docs/mcp/index.md): Architecture, features, and supported AI clients
- [MCP Quick Start](docs/mcp/quickstart.md): Setup for Augment, Claude Desktop, Cursor
- [Tools Reference](docs/mcp/tools-reference.md): All 78+ tools, 7 resources, 8 prompts
- [Deployment](docs/mcp/deployment.md): Cloud Run deployment with per-user PAT auth
- [MCP Context for AI](llms-mcp.txt): Standalone MCP-focused context file for AI agents

## API Reference

- [Client](docs/api/client.md): DevRevClient and AsyncDevRevClient classes
- [Configuration](docs/api/config.md): DevRevConfig settings and options
- [Exceptions](docs/api/exceptions.md): Error handling and exception types
- [Services](docs/api/services/index.md): All service modules (accounts, works, users, etc.)
- [Models](docs/api/models/index.md): Pydantic request/response models

## Services

- [Accounts](docs/api/services/accounts.md): Customer account management
- [Works](docs/api/services/works.md): Tickets, issues, and work items
- [Dev Users](docs/api/services/dev-users.md): Developer user management
- [Rev Users](docs/api/services/rev-users.md): Customer user management
- [Parts](docs/api/services/parts.md): Product parts and components
- [Articles](docs/api/services/articles.md): Knowledge base articles
- [Conversations](docs/api/services/conversations.md): Customer conversations
- [Tags](docs/api/services/tags.md): Tag management
- [Groups](docs/api/services/groups.md): Group management
- [Webhooks](docs/api/services/webhooks.md): Webhook configuration
- [SLAs](docs/api/services/slas.md): Service level agreements
- [Timeline Entries](docs/api/services/timeline-entries.md): Activity timeline
- [Links](docs/api/services/links.md): Object relationships
- [Code Changes](docs/api/services/code-changes.md): Code change tracking

## Guides

- [Sync vs Async](docs/guides/sync-vs-async.md): Choosing the right client
- [Pagination](docs/guides/pagination.md): Iterating large result sets
- [Error Handling](docs/guides/error-handling.md): Exception patterns and best practices
- [Logging](docs/guides/logging.md): Debugging and logging configuration
- [Configuration](docs/guides/configuration.md): Advanced configuration options
- [Testing](docs/guides/testing.md): Testing patterns for SDK usage

## Examples

- [Basic Usage](docs/examples/basic.md): Simple operations and getting started
- [Advanced Patterns](docs/examples/advanced.md): Concurrent requests, retries, webhooks
- [Integrations](docs/examples/integrations.md): FastAPI, Flask, Cloud Functions, Celery

## Optional

- [Beta API](docs/guides/beta-api.md): Beta features (incidents, engagements, search, recommendations)
- [Changelog](docs/changelog.md): Version history and migration guides
- [Version Support](docs/guides/version-support.md): Python version support policy
- [Compatibility](docs/guides/compatibility.md): Compatibility matrix
- [Full SDK Context](llms-ctx-full.txt): Comprehensive SDK reference for AI agents
- [SDK Context](llms-ctx.txt): Concise SDK reference for AI agents

