# Senu > Senu is an open-source Rust library (Apache-2.0). You declare a read-only function once, with its permission and parameters, and Senu serves it as an HTML page, a JSON API and an MCP tool for AI assistants, with the same authentication order, the same errors and one contract test suite for all three. It is built on Axum, Askama and the official rmcp SDK. Operations are read-only and served by GET, parameters are strings, and MCP runs over stdio. Writes, MCP over HTTP, sessions and OAuth are not part of version 0.2. Senu is not audited security software. Each link below is the Markdown source of one page; [llms-full.txt](https://senu.efg-technologies.com/llms-full.txt) holds all of them in one file. - Site: https://senu.efg-technologies.com/ (Japanese: https://senu.efg-technologies.com/ja/) - Source: https://github.com/efg-technologies/senu - API reference: https://docs.rs/senu - Crate: https://crates.io/crates/senu ## Library guide - [What Senu is and when to use it](https://senu.efg-technologies.com/overview.md): Senu is a Rust library that serves one declared function as an HTML page, a JSON API and an MCP tool, with the same checks in the same order on all three. - [Declare an operation](https://senu.efg-technologies.com/operations.md): An operation is a read-only function with a name, a description, a permission and string parameters. You declare it once as a constant and list it where it… - [Authenticate callers](https://senu.efg-technologies.com/authentication.md): Authentication in Senu is one trait: it turns a request's headers into a server-side principal, or into nothing. HTML pages and the JSON API each get their… - [Expose operations as MCP tools](https://senu.efg-technologies.com/mcp-tools.md): An operation becomes an MCP tool when you list it with mcp::tool. AI assistants then call the same function, behind the same permission check, that your JSON… - [Deploy and operate](https://senu.efg-technologies.com/deployment.md): Senu gives you an ordinary axum::Router. You bind it, put TLS in front of it and add the layers your service needs; Senu adds none of those and listens… - [Test with the contract](https://senu.efg-technologies.com/testing.md): Senu ships its own security tests as a kit. One call sends real requests through your routes and tools and fails when the rules that Senu promises do not hold… - [Questions and comparisons](https://senu.efg-technologies.com/faq.md): Short answers about what Senu is, how it compares with Axum, rmcp and Loco, and what version 0.2 can and cannot do. ## Course: learn Rust with Senu - [Start here: what you will build](https://senu.efg-technologies.com/start.md): This course takes you from "I have never written Rust" to changing a real Rust program and proving the change with a test. You will not build a toy in a… - [Install Rust and get the code](https://senu.efg-technologies.com/install.md): In this chapter you install Rust and Git, download Senu, and check that the tools work. Everything happens in the terminal, and the installers come from their… - [Your first page in the browser](https://senu.efg-technologies.com/first-page.md): Before you read any Rust, you will start Senu and open its pages in your browser. It is the same site you are reading now, served by your own computer. - [Write your first note](https://senu.efg-technologies.com/first-note.md): Every page of this site is a Markdown file in the content folder. Markdown is plain text with a few marks that become formatting. In this chapter you change… - [When Senu says no](https://senu.efg-technologies.com/when-senu-says-no.md): Senu checks every note before it starts serving. When a note breaks a rule, Senu prints what is wrong and where, and stops, so a broken page never reaches the… - [Your first Rust function](https://senu.efg-technologies.com/first-function.md): Every article page shows a reading time under its title, such as "About 1 min read". In this chapter you rebuild the Rust function that computes it, test… - [What you built, and where to go next](https://senu.efg-technologies.com/next-steps.md): You started a Rust program, read its pages in a browser, wrote notes in Markdown, met Senu's rules through its messages, and rebuilt one of its functions test… ## Notes - [A sample field note](https://senu.efg-technologies.com/sample-note.md): This note is a plain Markdown file: content/en/50-sample-note.md. Senu turned it into this page when it was built. ## Appendices - [Appendix: the project catalogue (optional)](https://senu.efg-technologies.com/appendix-catalogue.md): Besides articles, Senu has a second mode, senu serve. It shows a fixed list of sample projects as a web page and as JSON, a text format that programs read… - [Appendix: Senu over MCP (optional)](https://senu.efg-technologies.com/appendix-mcp.md): MCP, the Model Context Protocol, lets AI tools call functions in other programs. Senu can offer its project list as one MCP tool, list_projects. It does so…