ToolFront MCP Server

<p align="center"> <a href="https://github.com/statespace-tech/toolfront"> <img src="https://raw.githubusercontent.com/statespace-tech/toolfront/main/docs/assets/images/favicon.svg" width="150" alt="ToolFront"> </a> </p> <div align="center"> # ToolFront **Turn your data into shareable RAG apps in minutes. All in pure Markdown. Zero boilerplate.** [](https://github.com/statespace-tech/toolfront/actions/workflows/test.yml) [](https://www.python.org/downloads/) [](https://pypi.org/project/toolfront/) [](https://github.com/statespace-tech/toolfront/blob/main/LICENSE) [](https://discord.gg/rRyM7zkZTf) [](https://x.com/statespace_tech) </div> --- **Documentation: [docs.toolfront.ai](http://docs.toolfront.ai/)** **Source code: [https://github.com/statespace-tech/toolfront](https://github.com/statespace-tech/toolfront)** --- ## Simple example ToolFront is a declarative framework for building composable RAG applications in Markdown. ### Create it Start with one file: `README.md` ```yaml --- 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: ```bash toolfront serve . ``` > Runs at `http://127.0.0.1:8000` ### Connect it Connect your app to AI agents: <details open> <summary><b>Python SDK</b></summary> ```python from toolfront import Application app = Application(url="http://127.0.0.1:8000") result = app.ask("Is the service up?", model="openai:gpt-5") ``` </details> <details> <summary><b>Command line</b></summary> ```bash toolfront ask http://127.0.0.1:8000 "Is the service up?" --model "openai:gpt-5" ``` </details> <details> <summary><b>MCP server</b></summary> ```json { "mcpServers": { "toolfront": { "command": "uvx", "args": ["toolfront", "mcp", "http://127.0.0.1:8000"] } } } ``` </details> ## Complex example ### Upgrade it Your app can grow into a full project: ```bash project/ ├── README.md ├── data/ │ ├── log1.txt │ ├── log2.txt │ └── log3.txt └── src/ ├── agentic_rag.md ├── text2sql.md └── vector_search.md 3 directories, 9 files ``` Update `README.md` with tools to navigate other files: ```yaml --- 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 navigate other files ``` ### Compose it Add pages for different RAG workflows: <details open> <summary><b>Vector Search</b></summary> ```yaml --- tools: - [curl, -X, POST, https://host.pinecone.io/records/namespaces/user/search] --- # Vector search instructions: - Query documents with your vector database API ``` </details> <details> <summary><b>Text-to-SQL</b></summary> ```yaml --- tools: - [psql, -U, $USER, -d, $DB, -c, { regex: "^SELECT\b.*" }] --- # Text-to-SQL instructions: - Use `psql` for read-only PostgreSQL queries ``` </details> <details> <summary><b>Agentic RAG</b></summary> ```yaml --- tools: - [grep, -r, -i, { }, ../data/] --- # Document search instructions: - Use `grep` to search documents in `../data/` ``` </details> ### Deploy it Create a free [Statespace account](#deploy-it)[^1] and deploy your app to the cloud: ```bash toolfront deploy . ``` > Accessible at `https://<app-id>.toolfront.app`. Share it with the community or your team! ## Installation Install `toolfront` with your favorite PyPI package manager (Requires Python 3.10+). <details open> <summary><b>pip</b></summary> ```bash pip install toolfront ``` </details> <details> <summary><b>uv</b></summary> ```bash uv add toolfront ``` </details> <details> <summary><b>poetry</b></summary> ```bash poetry add toolfront ``` </details> ## Community & Contributing - **Discord**: Join our [community server](https://discord.gg/rRyM7zkZTf) for real-time help and discussions - **X**: Follow us [@statespace_tech](https://x.com/statespace_tech) for updates and news - **Issues**: Report bugs or request features on [GitHub Issues](https://github.com/statespace-tech/toolfront/issues) ## License This project is licensed under the terms of the MIT license. [^1]: Statespace is currently in beta. Email `esteban[at]statespace[dot]com` or join our [Discord](https://discord.gg/rRyM7zkZTf) to get an API key