{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_t4rhyjx3eqyd","handle":"aol-mcp","url":"https://wellknown.network/agents/aol-mcp","links":{"self":"https://wellknown.network/agents/aol-mcp/record.json","html":"https://wellknown.network/agents/aol-mcp","markdown":"https://wellknown.network/agents/aol-mcp/record.md","api":"https://wellknown.network/api/v1/agents/aol-mcp","status":"https://wellknown.network/api/v1/agents/aol-mcp/status","claim":"https://wellknown.network/agents/aol-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/aol-mcp/claim.json","badge":"https://wellknown.network/agents/aol-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json"},"ard":{"identifier":"urn:air::server:aol-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"aol-mcp","summary":"MCP server for AOL Mail via IMAP and SMTP","description":"# AOL Mail MCP Server\n\nA production-ready [Model Context Protocol](https://modelcontextprotocol.io) server for AOL Mail.  \nWorks as a local stdio MCP server compatible with **VS Code GitHub Copilot Agent Mode** and **Claude Desktop**.  \nUses **[uv](https://docs.astral.sh/uv/)** for dependency and environment management.\n\n---\n\n## Prerequisites\n\n- **uv** package manager (Python 3.11+ included automatically)\n- An AOL Mail account with IMAP access enabled\n- An AOL **app password** (not your main AOL password)\n\n### Install uv\n\n```bash\n# macOS / Linux\ncurl -LsSf https://astral.sh/uv/install.sh | sh\n\n# Windows (PowerShell)\npowershell -ExecutionPolicy ByPass -c \"irm https://astral.sh/uv/install.ps1 | iex\"\n```\n\nVerify: `uv --version`\n\n---\n\n## Generate an AOL App Password\n\n1. Sign in at [myaccount.aol.com](https://myaccount.aol.com).\n2. Go to **Security** → **Manage app passwords**.\n3. Enter a label (e.g. `MCP Server`) and click **Generate password**.\n4. Copy the generated password — this is your `AOL_APP_PASSWORD`.\n\n> AOL requires an app password for all third-party IMAP/SMTP clients.  \n> Standard account passwords will not work.\n\n---\n\n## Usage\n\nThere are three ways to run the server depending on your situation.\n\n### Option A — `uvx` (recommended, no install required)\n\nRuns directly from PyPI without cloning or installing anything permanently.\n\n```bash\nuvx aol-mcp\n```\n\nPass credentials via environment variables (see VS Code / Claude Desktop config below).\n\n### Option B — Install as a persistent tool\n\nInstall once, run anywhere by name.\n\n```bash\n# From PyPI\nuv tool install aol-mcp\n\n# From GitHub (before PyPI publish)\nuv tool install git+https://github.com/kubegrind/aol-mcp-server\n\n# From a local clone\nuv tool install .\n```\n\nThen run:\n\n```bash\nAOL_EMAIL=you@aol.com AOL_APP_PASSWORD=yourpassword aol-mcp\n```\n\n### Option C — Local clone (for development / contributors)\n\n```bash\ngit clone https://github.com/kubegrind/aol-mcp-server\ncd aol-mcp-server\nuv sync\ncp .env.example .env\n#…","publisher":null,"homepage":"https://github.com/kubegrind/aol-mcp-server","repository":"https://github.com/kubegrind/aol-mcp-server","version":"0.2.4","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:aol-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","repoUrl":"pypi","summary":"pypi","version":"pypi","description":"pypi","homepageUrl":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.768,"provenance":"derived"},{"slug":"dev.version-control","name":"Version Control","confidence":0.745,"provenance":"derived"},{"slug":"productivity.email","name":"Email","confidence":0.745,"provenance":"derived"}],"categories":["dev","productivity"],"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":"aol-mcp","registry":"pypi","observedAt":"2026-09-09T09:24:54.245Z","publishedAt":"2026-05-02T16:42:37.608672Z","latestVersion":"0.2.4"}},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"aol-mcp","url":"https://pypi.org/project/aol-mcp/","firstSeenAt":"2026-09-09T09:23:03.691Z","fetchedAt":"2026-09-09T09:23:03.691Z","normalizedAt":"2026-09-09T09:23:03.691Z"}]},"firstSeenAt":"2026-09-09T09:23:03.691Z","updatedAt":"2026-09-09T09:24:54.245Z"}