Documentation: docs.toolfront.ai
Source code: https://github.com/statespace-tech/toolfront
Quickstart
ToolFront is a declarative framework for building modular AI applications in Markdown. Write tools and instructions in .md files and get a live AI application.
Create it
Start with one file: README.md
---
tools:
- [curl, -X, GET, "https://httpbin.org/status/200"]
---
# Instructions
- Use `curl` to check if the service is up
Serve it
Run your app on your machine:
toolfront serve .
Runs at
http://127.0.0.1:8000
Ask it
Export your OPENAI_API_KEY and query your app:
Python SDK
from toolfront import Application
app = Application(url="http://127.0.0.1:8000")
result = app.ask("Is the service up?", model="openai:gpt-5")
MCP Server
{
"mcpServers": {
"toolfront": {
"command": "uvx",
"args": ["toolfront", "mcp", "http://127.0.0.1:8000"]
}
}
}
Command Line
toolfront ask http://127.0.0.1:8000 "Is the service up?"
Upgraded Example
Your app can grow into a full project:
project/
├── README.md # Main instructions & navigation tools
├── src/
│ ├── rag.md # Document search
│ ├── text2sql.md # Database query
│ └── toolkit.md # Custom workflow
├── data/
└── tools/
4 directories, 10 files
Add Navigation Tools
Update README.md with tools to explore the project.
---
tools:
- [curl, -X, GET, "https://httpbin.org/status/200"]
- [ls]
- [cat]
---
# Instructions
- Use `curl` to check if the service is up
- Use `ls` and `cat` to browse other files
Add Specialized Tools
Expand your app with specialized workflows.
Document Search
---
tools:
- [grep]
---
# Document Search
- Use `grep` for keyword searches in `data/`.
Text-to-SQL
---
tools:
- [psql, -U, $USER, -d, $DB, -c, { regex: "^SELECT\b.*" }]
---
# Database Access
- Call `psql` to query the database with read-only SELECT statements
Custom Scripts
---
tools:
- [python3, tools/analyze.py]
---
# Custom Tools
- Run `analyze.py` to process data, passing `--input` as needed
Deploy It
Create a free Statespace account1 and deploy your app in one command.
toolfront deploy .
Deploys to
https://your-app.toolfront.app. Share it with the community or your team!
Installation
Install toolfront with your favorite PyPI package manager (Requires Python 3.10+).
pip
pip install toolfront
uv
uv add toolfront
poetry
poetry add toolfront
Community & Contributing
- Discord: Join our community server for real-time help and discussions
- X: Follow us @statespace_tech for updates and news
- Issues: Report bugs or request features on GitHub Issues
License
This project is licensed under the terms of the MIT license.
Metadata
Release files for iflow-mcp_toolfront 0.4.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| iflow_mcp_toolfront-0.4.1.tar.gz | 19.3 kB | Without provenance | Details for iflow_mcp_toolfront-0.4.1.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| iflow_mcp_toolfront-0.4.1-py3-none-any.whl | Python 3 | none | any | Details for iflow_mcp_toolfront-0.4.1-py3-none-any.whl |
Total release size: 42.9 kB
Release files / iflow_mcp_toolfront-0.4.1.tar.gz
| Download URL | iflow_mcp_toolfront-0.4.1.tar.gz |
|---|---|
| Size | 19.3 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
c699d631cb4b50b4d6ea8bd510909da576c57e69f2d269455214be7840560e7e
|
|
BLAKE2b-256 checksum How to use checksums |
7fae8560c1c221a9e20859e264bb17f31f8d40a7d8b72290e0263846d7502326
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Release files / iflow_mcp_toolfront-0.4.1-py3-none-any.whl
| Download URL | iflow_mcp_toolfront-0.4.1-py3-none-any.whl |
|---|---|
| Size | 23.6 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
9bfa238247860e813f8e2b02f739e4092094af50d696dceeeb6b07c68199f571
|
|
BLAKE2b-256 checksum How to use checksums |
4f891e2f5234de46ccbaef7f187cf55136780e73c16a3361f2be1f92262c1dff
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
uv/0.9.10 {"installer":{"name":"uv","version":"0.9.10"},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"macOS","version":null,"id":null,"libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
|
Security for iflow-mcp_toolfront 0.4.1
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.