Metadata-Version: 2.4
Name: contextportal
Version: 0.1.0
Summary: The authenticated fetch layer for AI agents.
Author: NavadeepDj
License-Expression: MIT
Project-URL: Homepage, https://github.com/NavadeepDj/ContextPortal
Project-URL: Repository, https://github.com/NavadeepDj/ContextPortal
Project-URL: Issues, https://github.com/NavadeepDj/ContextPortal/issues
Keywords: mcp,ai-agents,retrieval,browser-automation,context-proxy,security
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: OS Independent
Requires-Python: >=3.12
Description-Content-Type: text/markdown
Requires-Dist: fastapi>=0.115.0
Requires-Dist: uvicorn[standard]>=0.30.0
Requires-Dist: redis[hiredis]>=5.0.0
Requires-Dist: pydantic-settings>=2.4.0
Requires-Dist: httpx>=0.27.0
Requires-Dist: playwright>=1.62.0
Requires-Dist: readability-lxml>=0.8.4.1
Requires-Dist: markdownify>=1.2.3
Requires-Dist: mcp[cli]>=2.1.1
Provides-Extra: dev
Requires-Dist: pytest>=8.0.0; extra == "dev"
Requires-Dist: pytest-asyncio>=0.24.0; extra == "dev"
Requires-Dist: pytest-cov>=5.0.0; extra == "dev"
Requires-Dist: ruff>=0.6.0; extra == "dev"
Requires-Dist: mypy>=1.11.0; extra == "dev"
Requires-Dist: twine>=5.0.0; extra == "dev"

# 🔑 ContextPortal

> **Give your AI agent access to authenticated web pages — without giving it your credentials.**

Your AI agent can fetch any public webpage. But the moment it hits a login wall — Jira, Confluence, internal wikis, enterprise dashboards — it's stuck.

ContextPortal sits between your AI agent and the web. When the agent needs a protected page, ContextPortal uses *your* existing browser session to grab it, strips out all the noise, and hands back clean Markdown. The agent gets context. It never gets your cookies.

> 🍪 *Agent: "Can I have your cookies?"*  
> 🚫 *ContextPortal: "No. Here's the page."*

## Install

```bash
uv tool install contextportal
```

## Setup

```bash
# Log into your private sites (once)
contextportal login

# Test it
contextportal fetch https://your-protected-site.com/docs
```

## Connect to your AI Agent

```json
{
  "mcpServers": {
    "context-portal": {
      "command": "contextportal",
      "args": ["mcp"]
    }
  }
}
```

Works with **Cursor**, **Claude Desktop**, **Antigravity**, **VS Code**, and any MCP-compatible client.

## Learn More

- 📖 [Full Documentation](https://github.com/NavadeepDj/ContextPortal)
- 🔐 [Security Model](https://github.com/NavadeepDj/ContextPortal/blob/main/docs/security-and-automation-philosophy.md)
- 🗺️ [Product Roadmap](https://github.com/NavadeepDj/ContextPortal/blob/main/PRODUCT_ROADMAP.md)
