# Reported issues for agentos

Pod holds 17 of 18 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [agentos](/mcp/agentos).

## Most discussed

### MCP server has no functional integration tests

test_mcp_server.py only checks initialization and tool count (18 tools). No actual MCP protocol compliance or tool execution tests.

**Fix:** Add end-to-end tests with MCP client.

---
*Found by AI Native Daemon -- critical package audit*

[Read the thread](https://github.com/imran-siddique/agent-os/issues/286) · 2026-02-22 · closed · 4 comments

### feat: List MCP server on Glama marketplace

## Context
@punkpeye at awesome-mcp-servers [PR #1814](https://github.com/punkpeye/awesome-mcp-servers/pull/1814) requires Glama listing before merging.

## Steps
- [ ] Submit server at https://glama.ai/mcp/servers (repo: imran-siddique/agent-os)
- [ ] Wait for automated checks to pass (Docker build, security scan, license)
- [ ] Get Glama listing URL
- [ ] Update [PR #1814](https://github.com/punkpeye/awesome-mcp-servers/pull/1814) with \[glama](...)\ link after GitHub URL
- [ ] Comment on PR t

[Read the thread](https://github.com/imran-siddique/agent-os/issues/298) · 2026-02-26 · closed · 3 comments

### Missing Integration Tests for MCP Server Protocol Compliance

**Category:** missing-tests
**Priority:** medium

**Description**
The MCP (Model Context Protocol) server implementation lacks functional integration tests. Current tests only verify initialization and tool count, but don't validate actual MCP protocol compliance or end-to-end tool execution.

**Evidence**
- Issue #286 specifically identifies that `test_mcp_server.py` only checks initialization and tool count (18 tools)
- No actual MCP protocol compliance tests exist
- No tool execution verifica

[Read the thread](https://github.com/imran-siddique/agent-os/issues/292) · 2026-02-23 · closed · 3 comments

### GitHub App: Create and configure GitHub App for Copilot Extension

Create the GitHub App for the AgentOS Copilot Extension.

**Reference:** extensions/copilot/PUBLISHING.md

**Tasks:**
- [ ] Create GitHub App at GitHub Settings > Developer settings > GitHub Apps
- [ ] Configure permissions (contents, pull_requests, workflows, actions, metadata, copilot_chat)
- [ ] Set up webhook URL
- [ ] Generate and store private key
- [ ] Configure OAuth callback URLs
- [ ] Enable Copilot Extension settings (Agent type)

**Manifest template:** extensions/copilot/github-app-m

[Read the thread](https://github.com/imran-siddique/agent-os/issues/19) · 2026-01-31 · closed · 2 comments

### feat: Add prompt injection detection to input validation pipeline

## Summary
The input validation layer currently handles schema validation and policy checks, but lacks dedicated prompt injection detection. As agentic AI systems handle increasingly complex multi-turn interactions, prompt injection has become a top attack vector (OWASP Agentic AI Top 10, LLM06).

## Motivation
- Agents that accept natural language input (prompts, tool descriptions, MCP payloads) are vulnerable to injection attacks
- Current policy engine evaluates governance rules but doesn't s

[Read the thread](https://github.com/imran-siddique/agent-os/issues/299) · 2026-02-26 · closed · 1 comment

### Tutorial: Add governance to a LangChain agent in 5 minutes

## Goal
Write a quick tutorial showing how to wrap an existing LangChain agent with Agent OS governance in under 5 minutes.

## What to Include
- Install both packages
- Create a simple LangChain agent
- Wrap it with `LangChainKernel().wrap(agent)`
- Show before/after: ungoverned vs governed behavior
- Include test to verify policy enforcement

## Where
Create `tutorials/langchain-quickstart/README.md` and `tutorials/langchain-quickstart/main.py`

## Skills Needed
- Python, basic LangChain knowl

[Read the thread](https://github.com/imran-siddique/agent-os/issues/271) · 2026-02-21 · closed · 1 comment

### [Feature] Add Google Gemini adapter

Create a governance adapter for Google Gemini API.

**File:** New: `src/agent_os/integrations/gemini_adapter.py`

**Hints:**
- Inherit from BaseIntegration
- Intercept function_call blocks
- Support safety settings governance
- Add tests in test_integrations.py

[Read the thread](https://github.com/imran-siddique/agent-os/issues/191) · 2026-02-09 · closed · 1 comment

### [Code] Add type hints to base integration

Improve type hints in the base integration module.

**File:** `src/agent_os/integrations/base.py`

**Hints:**
- Type all method parameters
- Use Protocol for callback types
- Add TypeVar for generic integration
- Run mypy to verify correctness

[Read the thread](https://github.com/imran-siddique/agent-os/issues/189) · 2026-02-09 · closed · 1 comment

## Most recent

### [Feature] Add policy violation webhook notifications

Send webhook notifications when policy violations are detected.

**File:** `src/agent_os/base_agent.py`

**Hints:**
- Add `webhook_url` to AgentConfig
- POST violation details to webhook on detection
- Make async to avoid blocking
- Include agent_id, violation_type, timestamp

[Read the thread](https://github.com/imran-siddique/agent-os/issues/171) · 2026-02-09 · closed · 1 comment

### [Test] Add tests for LangChain batch governance

Test that batch operations are governed correctly.

**File:** `tests/test_integrations.py`

**Hints:**
- Create governed LangChain runnable
- Run batch of 5 inputs
- Verify each was policy-checked
- Test with some inputs violating policy

[Read the thread](https://github.com/imran-siddique/agent-os/issues/160) · 2026-02-09 · closed · 0 comments

### [Docs] Document MCP server tools and schemas

Document all 15 MCP tools with their schemas and usage.

**File:** New file or README section

**Hints:**
- List all tools: CMVKVerify, KernelExecute, IATPSign, etc.
- Document input/output schemas
- Include curl/Claude Desktop usage examples

[Read the thread](https://github.com/imran-siddique/agent-os/issues/150) · 2026-02-09 · closed · 0 comments

### [Docs] Add docstrings to OpenAI adapter

Add comprehensive docstrings to all methods in the OpenAI integration.

**File:** `src/agent_os/integrations/openai_adapter.py`

**Hints:**
- Document the wrapping strategy
- Explain SIGKILL support
- Include usage examples

[Read the thread](https://github.com/imran-siddique/agent-os/issues/144) · 2026-02-09 · closed · 0 comments

### [Docs] Document the GovernancePolicy dataclass

Add detailed docstrings to GovernancePolicy and all its fields.

**File:** `src/agent_os/integrations/base.py`

**Hints:**
- Document each field with type, default, and purpose
- Explain how policies compose
- Add example policy configurations

[Read the thread](https://github.com/imran-siddique/agent-os/issues/140) · 2026-02-09 · closed · 0 comments

### [Feature] Add `agentos serve` CLI command for HTTP API

Implement an HTTP API server command for the CLI.

**File:** `src/agent_os/cli.py:14`

**Hints:**
- Add `serve` subcommand to argparse
- Use uvicorn or http.server for a simple server
- Expose `/health` and `/status` endpoints
- Accept `--port` and `--host` arguments

[Read the thread](https://github.com/imran-siddique/agent-os/issues/124) · 2026-02-09 · closed · 1 comment

### Add example: Governed chatbot with memory

**Description**
Create a simple example showing a chatbot that uses Agent OS governance with conversation memory.

**Requirements**
- Use the EMK (Episodic Memory Kernel) module
- Show how policies can restrict what the chatbot remembers
- Include a README explaining the example

**Good for:**
- Learning the codebase
- Python developers new to Agent OS

**Files to modify:**
- `examples/chat-agent/` (create or modify)

[Read the thread](https://github.com/imran-siddique/agent-os/issues/64) · 2026-02-03 · closed · 1 comment

### MCP Server: Publish to GitHub MCP Registry and verify cross-platform support

## Overview
With GitHub Copilot Extensions (GitHub Apps) deprecated in favor of MCP, we should focus on distributing the existing MCP server implementation.

**Background:** https://github.blog/changelog/2025-09-24-deprecate-github-copilot-extensions-github-apps/

## Current State
The MCP server at \xtensions/mcp-server/\ is fully functional with:
- 10 MCP tools
- Policy engine
- Compliance checking
- npm package: \@agentos/mcp-server\

## Tasks

### Phase 1: Verification
- [ ] Verify npm packa

[Read the thread](https://github.com/imran-siddique/agent-os/issues/53) · 2026-02-02 · closed · 0 comments

### Docs: Clarify Shadow Mode multi-step fidelity limitations

Shadow Mode diverges from reality after first simulated step for multi-step agents. Need replay engine with recorded real outputs, or clearly document single-step-only fidelity guarantee.

[Read the thread](https://github.com/imran-siddique/agent-os/issues/43) · 2026-01-31 · closed · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/imran-siddique/agent-os/issues).