{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_hnxm5j2hprp5","handle":"iflow-mcp-hileamlakb-prims","url":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims","links":{"self":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims/record.json","html":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims","markdown":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-hileamlakb-prims","status":"https://wellknown.network/api/v1/agents/iflow-mcp-hileamlakb-prims/status","claim":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-hileamlakb-prims/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-hileamlakb-prims/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-hileamlakb-prims/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-hileamlakb-prims","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_hileamlakb-prims","summary":"Python Runtime Interpreter MCP Server","description":"<p align=\"left\">\n  <img src=\"primslogo.png\" alt=\"PRIMS Logo\" width=\"200\"/>\n  <a href=\"#\"><img src=\"https://img.shields.io/badge/status-alpha-orange?style=for-the-badge\" alt=\"Status: Alpha\"/></a>\n  <a href=\"LICENSE\"><img src=\"https://img.shields.io/badge/license-MIT-blue?style=for-the-badge\" alt=\"License: MIT\"/></a>\n</p>\n\n# PRIMS – Python Runtime Interpreter MCP Server\n\nPRIMS is a tiny open-source **Model Context Protocol (MCP)** server that lets LLM agents run arbitrary Python code in a secure, throw-away sandbox.\n\n•   **One tool, one job.**  Exposes a single MCP tool – `run_code` – that executes user-supplied Python and streams back `stdout / stderr`.\n\n•   **Isolated & reproducible.**  Each call spins up a fresh virtual-env, installs any requested pip packages, mounts optional read-only files, then nukes the workspace.\n\n•   **Zero config.**  Works over MCP/stdio or drop it in Docker.\n\n---\n\n## Quick-start\n\n### 1. Local development environment\n\n```bash\nchmod +x scripts/setup_env.sh   # once, to make the script executable\n./scripts/setup_env.sh          # creates .venv & installs deps\n\n# activate the venv in each new shell\nsource .venv/bin/activate\n```\n\n### 2. Launch the server\n\n```bash\npython -m server.main         # binds http://0.0.0.0:9000/mcp\n```\n\n### 3. Docker\n\n```bash\n# Quick one-liner (build + run)\nchmod +x scripts/docker_run.sh\n./scripts/docker_run.sh         # prints the MCP URL when ready\n```\n\n## Examples\n\n### List available tools\n\nYou can use the provided script to list all tools exposed by the server:\n\n```bash\npython examples/list_tools.py\n```\n\nExpected output (tool names and descriptions may vary):\n\n```\nAvailable tools:\n- run_code: Execute Python code in a secure sandbox with optional dependencies & file mounts.\n- list_dir: List files/directories in your session workspace.\n- preview_file: Preview up to 8 KB of a text file from your session workspace.\n- persist_artifact: Upload an output/ file to a presigned URL for permanent storage.\n- mount_file: Downl…","publisher":{"name":"PRIMS Contributors","url":null},"homepage":null,"repository":null,"version":"0.1.0","license":"MIT License  Copyright (c) 2025 Hileamlak Mulugeta Yitayew  Per…","protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_hileamlakb-prims","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","license":"pypi","summary":"pypi","version":"pypi","description":"pypi","publisherName":"pypi"}},"derived":{"capabilities":[{"slug":"code.execution","name":"Code Execution","confidence":1,"provenance":"derived"},{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.859,"provenance":"derived"},{"slug":"dev.terminal","name":"Terminal & Shell","confidence":0.745,"provenance":"derived"}],"categories":["code","dev"],"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":"iflow-mcp_hileamlakb-prims","registry":"pypi","observedAt":"2026-10-28T04:28:31.345Z","publishedAt":"2026-02-09T23:23:49.413475Z","latestVersion":"0.1.0"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_hileamlakb-prims","url":"https://pypi.org/project/iflow-mcp_hileamlakb-prims/","firstSeenAt":"2026-09-09T19:23:37.027Z","fetchedAt":"2026-10-28T04:27:39.229Z","normalizedAt":"2026-10-28T04:27:39.229Z"}]},"firstSeenAt":"2026-09-09T19:23:37.027Z","updatedAt":"2026-10-28T04:28:31.345Z"}