{"id":"privy-mcp-server","name":"privy-mcp-server","homepage":"https://pypi.org/project/privy-mcp-server/","repo_url":"https://github.com/incentivai-io/privy-mcp-server","category":"infrastructure","subcategories":[],"tags":["mcp","privy","web3","wallet-management","user-management","python","developer-tools"],"what_it_does":"Provides an MCP server (Python) that connects to Privy.io’s API to manage users and wallets, including user lookup/creation/deletion, wallet creation and metadata updates, balance checks, and paginated transaction history. Intended for use with Claude Desktop and other MCP clients.","use_cases":["Automate Privy user lookups (by DID and by wallet address) from an MCP client","Provision users and (optionally) embedded wallets through natural-language workflows","Fetch wallet balances and transaction history with pagination","Support internal ops tooling for wallet metadata management and audits"],"not_for":["Handling production-critical flows without validating MCP tool schemas/behavior and without proper operational safeguards","Implementing user-facing customer workflows that require strong audit trails and human approval for destructive actions (e.g., delete)","Situations where you cannot securely store and protect Privy API credentials"],"best_when":"You want an MCP-compatible interface to Privy.io for developer/ops automation, and you can run the server in a controlled environment with protected environment variables.","avoid_when":"You need a strongly standardized HTTP/REST integration for broad tooling, or you require documented idempotency/retry semantics before performing write/delete operations.","alternatives":["Direct Privy.io API integration (official Privy REST API)","Build a custom wrapper service exposing your own REST/GraphQL endpoints for internal tooling","Use another MCP server (or your own MCP server) that provides a narrower, audited surface area over Privy APIs"],"af_score":68.8,"security_score":63.5,"reliability_score":21.2,"package_type":"mcp_server","discovery_source":["pypi"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T21:47:57.890276+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["HTTP Basic Authentication with custom headers (Authorization: Basic base64(app_id:app_secret) and privy-app-id header)"],"oauth":false,"scopes":false,"notes":"Authentication is configured via PRIVY_APP_ID and PRIVY_APP_SECRET environment variables. README does not describe fine-grained scopes; likely Privy app credentials grant broad access to the Privy application."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"No pricing information for the MCP server is provided; costs would primarily come from Privy.io and your hosting/runtime."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":68.8,"security_score":63.5,"reliability_score":21.2,"mcp_server_quality":70.0,"documentation_accuracy":75.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":85.0,"rate_limit_clarity":70.0,"tls_enforcement":100.0,"auth_strength":65.0,"scope_granularity":20.0,"dependency_hygiene":55.0,"secret_handling":75.0,"security_notes":"Uses HTTPS to api.privy.io and instructs credentials via environment variables (reducing accidental commits). However, authentication is tied to app_id/app_secret (appears coarse-grained) and README does not discuss scope restrictions or least-privilege guidance. Destructive capabilities (delete_user) increase operational risk for agent misuse; ensure strict access controls and human-in-the-loop where appropriate.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":0.0,"error_recovery":55.0,"idempotency_support":"false","idempotency_notes":null,"pagination_style":"cursor_or_page_params","retry_guidance_documented":true,"known_agent_gotchas":["Destructive operations exist (e.g., delete_user) and should be guarded in agent workflows; README states delete is permanent.","The server relies on proper environment variable loading; if env vars are missing/incorrect, authentication errors will occur.","Rate limits are documented at a high level; agents may need retry/backoff logic to avoid 429s.","Pagination is described as page-based (default 50); ensure the agent passes/consumes pagination parameters correctly."]}}