{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_n4tzj44rxe59","handle":"python-interpreter-mcp","url":"https://wellknown.network/agents/python-interpreter-mcp","links":{"self":"https://wellknown.network/agents/python-interpreter-mcp/record.json","html":"https://wellknown.network/agents/python-interpreter-mcp","markdown":"https://wellknown.network/agents/python-interpreter-mcp/record.md","api":"https://wellknown.network/api/v1/agents/python-interpreter-mcp","status":"https://wellknown.network/api/v1/agents/python-interpreter-mcp/status","claim":"https://wellknown.network/agents/python-interpreter-mcp/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/python-interpreter-mcp/claim.json","badge":"https://wellknown.network/agents/python-interpreter-mcp/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/python-interpreter-mcp/history","tools":"https://wellknown.network/api/v1/agents/python-interpreter-mcp/tools"},"ard":{"identifier":"urn:air::server:python-interpreter-mcp","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"python-interpreter-mcp","summary":"A Model Context Server providing simple features to automate python script execution via LLMs","description":"## python-interpreter-mcp: A MCP server to run scripts\n\n## Overview\nA lightweight, experimental MCP server designed to execute arbitrary Python scripts in a structured and reproducible environment. It leverages **[uv](https://github.com/astral-sh/uv)** to run isolated code snippets through subprocesses.\n\n### Tools\n- `run_script`\n   - Runs the given script with `uv run script.py`.\n   - Input: \n     - `code`(str): Script to be run\n   - Return: The stdout of the given script.\n\n## Configuration\n### Usage with OpenAI Agents SDK\n\n```python\nasync with MCPServerStdio(\n            params={\n                \"command\": \"uvx\",\n                \"args\": [\"python-interpreter-mcp\"],\n            }\n    ) as server\n...\n```\n\n### Usage with Claude Desktop\nAdd this to your `claude_desktop_config.json`:\n```json\n\"mcpServers\": {\n  \"interpreter\": {\n    \"command\": \"uvx\",\n    \"args\": [\"python-interpreter-mcp\"]\n  }\n}\n```\n\n## How it works\n\n- A script string is received by the MCP tool `run_script`.\n- A hidden folder is created in cwd, and the script is saved as a `.py` file inside it.\n- The script is then executed using `uv run`, which ensures dependency isolation.\n- The stdout of the script is captured and returned as the response.\n\n## Usage Warnings\n**This project is in a very early stage of development.**\n\n### ⚠️ Important notes\n- It executes arbitrary Python code, which means it can run anything — including malicious or destructive commands.\n- Use only in trusted, sandboxed environments.\n- You should always validate, guardrail, or restrict inputs when wiring this into an LLM.","publisher":{"name":"Bimal Paudel","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":null,"protocols":["mcp"],"tags":["automation","llm","mcp","python"],"pricing":null,"endpoints":[{"url":"pypi:python-interpreter-mcp","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.execution","name":"Code Execution","confidence":1,"provenance":"derived"}],"categories":["code"],"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":"python-interpreter-mcp","registry":"pypi","observedAt":"2026-10-28T20:23:15.016Z","publishedAt":"2025-04-19T11:49:28.981225Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"python-interpreter-mcp","url":"https://pypi.org/project/python-interpreter-mcp/","firstSeenAt":"2026-09-10T10:24:49.553Z","fetchedAt":"2026-10-28T20:22:12.100Z","normalizedAt":"2026-10-28T20:22:12.100Z"}]},"firstSeenAt":"2026-09-10T10:24:49.553Z","updatedAt":"2026-10-28T20:23:15.016Z"}