README.md

metadata

title: Text Adventure Agent
emoji: 🤖
colorFrom: blue
colorTo: green
sdk: gradio
sdk_version: 5.16.0
app_file: app.py
pinned: false
license: apache-2.0

Example: MCP ReAct Agent

This is a complete, working example submission that demonstrates a ReAct agent using MCP.

Approach

This agent uses the full ReAct pattern:

1. Thought: Reason about the current situation
2. Tool: Choose and call an MCP tool
3. Observation: Process the result

Features:

• Loop detection (avoids repeating the same action)
• Action validation (fixes common invalid verbs)
• Score tracking
• History management

Files

• agent.py - ReAct agent with full implementation
• mcp_server.py - MCP server with memory, map, and inventory tools

Testing

# Test locally
python agent.py