{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_dmanhtqzf9nh","handle":"mmodal-mcp","url":"https://wellknown.network/agents/mmodal-mcp","links":{"self":"https://wellknown.network/agents/mmodal-mcp/record.json","html":"https://wellknown.network/agents/mmodal-mcp","markdown":"https://wellknown.network/agents/mmodal-mcp/record.md","api":"https://wellknown.network/api/v1/agents/mmodal-mcp","status":"https://wellknown.network/api/v1/agents/mmodal-mcp/status","claim":"https://wellknown.network/agents/mmodal-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mmodal-mcp/claim.json","badge":"https://wellknown.network/agents/mmodal-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mmodal-mcp/history","tools":"https://wellknown.network/api/v1/agents/mmodal-mcp/tools"},"ard":{"identifier":"urn:air::server:mmodal-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mmodal-mcp","summary":"Multimodal MCP server for generating images and describing assets across providers.","description":"# mmodal-mcp\n\nGive **any MCP client**—CLI tools, packaged vendor agents, custom automations, or IDE integrations—the visual skills they’re missing. mmodal-mcp is a FastMCP server that wraps LiteLLM so assistants can generate new imagery and produce rich descriptions of existing assets (images, decks, spreadsheets, PDFs) through guided, agent-friendly prompts.\n\n## Why It Matters\n\n- **Fill the gap**: Most copilots and command-line assistants can’t inspect PDFs, decks, or screenshots. This server adds that superpower through MCP tools.\n- **Consistent guidance**: Validation returns actionable checklists, so autonomous agents can retry with confidence.\n- **Bring your own provider**: Point LiteLLM at Gemini/Imagen, OpenAI DALL·E, or your own inference stack—no code changes required.\n- **Fits any MCP client**: Use it from CLI tools, packaged vendor agents, custom automation, or GUI wrappers—if the client speaks MCP, it can use mmodal-mcp.\n\n## Quick MCP Configs\n\n### Custom Agents & CI Automation\n\n```bash\nuv run python scripts/fastmcp_pipeline.py\n```\n\nThe script launches the server via stdio, calls each tool, and prints sanitized responses—ideal for bespoke agents, QA jobs, or integration tests.\n\n### Claude Code CLI\n\n```bash\nclaude mcp add mmodal \\\n  -e LITELLM_DEFAULT_MODEL=gemini/imagen-4.0-generate-001 \\\n  -e LITELLM_DEFAULT_API_KEY=your-gemini-key \\\n  -- uvx --from mmodal-mcp mmodal-mcp\n```\n\n### Claude Desktop (macOS / Windows)\n\n```json\n{\n  \"mmodal\": {\n    \"command\": \"uvx\",\n    \"args\": [\"--from\", \"mmodal-mcp\", \"mmodal-mcp\"],\n    \"env\": {\n      \"LITELLM_DEFAULT_MODEL\": \"gemini/imagen-4.0-generate-001\",\n      \"LITELLM_DEFAULT_API_KEY\": \"your-gemini-key\"\n    }\n  }\n}\n```\n\nSave in `~/Library/Application Support/Claude/mcp/config.json` (macOS) or `%APPDATA%/Claude/mcp/config.json` (Windows) and restart Claude Desktop.\n\n### Cursor / Windsurf / Other MCP-Aware IDEs\n\n```json\n{\n  \"mcpServers\": {\n    \"mmodal\": {\n      \"command\": \"uvx\",\n      \"args\": [\"--from\", \"mmodal-mcp\", \"mmoda…","publisher":{"name":"mmodal-mcp contributors","url":null},"homepage":null,"repository":null,"version":"0.8.5","license":"MIT","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mmodal-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.825,"provenance":"derived"},{"slug":"dev.ci-cd","name":"CI/CD & Deploy","confidence":0.756,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"mmodal-mcp","registry":"pypi","observedAt":"2026-10-28T15:26:26.146Z","publishedAt":"2025-11-07T15:59:46.689984Z","latestVersion":"0.8.5"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mmodal-mcp","url":"https://pypi.org/project/mmodal-mcp/","firstSeenAt":"2026-09-10T06:23:26.263Z","fetchedAt":"2026-10-28T15:25:40.860Z","normalizedAt":"2026-10-28T15:25:40.860Z"}]},"firstSeenAt":"2026-09-10T06:23:26.263Z","updatedAt":"2026-10-28T15:26:26.146Z"}