{"id":5763,"date":"2025-07-02T22:36:56","date_gmt":"2025-07-02T21:36:56","guid":{"rendered":"https:\/\/villpress.com\/?p=5763"},"modified":"2025-07-02T22:37:34","modified_gmt":"2025-07-02T21:37:34","slug":"tiny-agents-a-mcp-powered-agent-in-50-lines-of-code","status":"publish","type":"post","link":"https:\/\/villpress.com\/cs\/tiny-agents-a-mcp-powered-agent-in-50-lines-of-code\/","title":{"rendered":"Tiny Agents: A MCP-Powered Agent in 50 Lines of Code"},"content":{"rendered":"

Have you ever thought about building your own AI agent, something like ChatGPT that can do tasks, answer questions, and even use tools like a calculator or search engine? What if I told you that you can create one using only 50 lines of code<\/strong>?<\/p>\n\n\n\n

In this article, We\u2019ll walk you through how to build a tiny but powerful AI agent<\/a><\/strong> using something called the Model Context Protocol (MCP)<\/strong>. We\u2019ll keep everything simple and easy to follow, even if you’re not a coding expert. By the end, you\u2019ll understand how this works, and you might even be ready to build one yourself.<\/p>\n\n\n\n

What Is a Tiny Agent?<\/strong><\/h2>\n\n\n\n

A tiny agent<\/strong> is a small program that talks to a large AI model (like ChatGPT), but with a twist\u2014it can think, plan, and use tools<\/strong> to complete tasks.<\/p>\n\n\n\n

Think of it like this:<\/p>\n\n\n\n

\n

A chatbot gives answers.
A tiny agent<\/strong> can decide what steps to take<\/strong>, use tools<\/strong>, and then give you a better answer<\/strong>.<\/p>\n<\/blockquote>\n\n\n\n

For example, if you ask it, “What’s the weather in Lagos?”<\/em>\u2014instead of guessing, it can use a weather tool to check and then give you the actual answer.<\/p>\n\n\n\n

What is MCP (Model Context Protocol)?<\/strong><\/h2>\n\n\n\n

Let\u2019s break it down in simple terms.<\/p>\n\n\n\n

Model Context Protocol (MCP)<\/strong> is a set of rules that helps AI models and tools talk to each other<\/strong>. It\u2019s like a translator between the brain (the AI) and the hands (the tools).<\/p>\n\n\n\n

With MCP:<\/p>\n\n\n\n

    \n
  • The AI model understands what tools are available.<\/li>\n\n\n\n
  • It knows when<\/strong> to use them.<\/li>\n\n\n\n
  • It learns from past actions<\/strong> to improve future answers.<\/li>\n<\/ul>\n\n\n\n

    It turns a regular chatbot into a smart agent<\/strong> that can think and act.<\/p>\n\n\n\n

    Why Build a Tiny Agent?<\/strong><\/h2>\n\n\n\n

    You might wonder\u2014why bother making a tiny agent?<\/p>\n\n\n\n

    Here are some great reasons:<\/p>\n\n\n\n

      \n
    • It\u2019s fast to build<\/strong> \u2013 Just 50 lines of code.<\/li>\n\n\n\n
    • You learn a lot<\/strong> \u2013 You get to understand how AI tools really work.<\/li>\n\n\n\n
    • You can customize it<\/strong> \u2013 Want it to help with your tasks? You can set that up.<\/li>\n\n\n\n
    • It saves resources<\/strong> \u2013 Lightweight code means it runs easily without needing powerful computers.<\/li>\n<\/ul>\n\n\n\n

      So even if you\u2019re just starting, you can do this<\/strong>.<\/p>\n\n\n\n

      What You Need to Get Started<\/strong><\/h2>\n\n\n\n

      To build your tiny agent, here are the basic things you\u2019ll need:<\/p>\n\n\n\n

        \n
      1. Node.js is installed<\/strong> on your computer (this lets you run JavaScript code).<\/li>\n\n\n\n
      2. A bit of knowledge in JavaScript or TypeScript<\/strong> (don\u2019t worry, you can still follow if you’re learning).<\/li>\n\n\n\n
      3. Access to an AI model provider like Hugging Face<\/strong>.<\/li>\n\n\n\n
      4. An API key<\/strong> from that provider.<\/li>\n\n\n\n
      5. A code editor like VS Code<\/strong>.<\/li>\n<\/ol>\n\n\n\n

        Once you\u2019re ready, install the needed tools by running this in your terminal:<\/p>\n\n\n\n

        bashCopyEditnpm install @mcp\/tokenizer @mcp\/agent @huggingface\/inference\n<\/code><\/pre>\n\n\n\n
        These tools will help your tiny agent talk to the AI model and use tools.<\/p>\n\n\n\n
        The 3 Tools You\u2019ll Use<\/strong><\/h2>\n\n\n\n
        Here\u2019s what each part does:<\/p>\n\n\n\n
        @mcp\/tokenizer<\/strong><\/h3>\n\n\n\n
        This helps prepare the message you want to send to the AI model.<\/p>\n\n\n\n
        @mcp\/agent<\/strong><\/h3>\n\n\n\n
        This is the heart of your tiny agent. It handles decisions like when to use tools or what to say next.<\/p>\n\n\n\n
        @huggingface\/inference<\/strong><\/h3>\n\n\n\n
        This lets you use AI models from Hugging Face easily.<\/p>\n\n\n\n
        Together, these give you everything you need to create a smart, tiny agent.<\/p>\n\n\n\n
        Understanding the Agent\u2019s Workflow<\/strong><\/h2>\n\n\n\n
        Let\u2019s look at how the agent works<\/strong> in five simple steps:<\/p>\n\n\n\n
          \n
        1. You type something<\/strong> (like a question).<\/li>\n\n\n\n
        2. The agent sends it to the AI model<\/strong>.<\/li>\n\n\n\n
        3. The model decides<\/strong> whether to use a tool (like a search tool).<\/li>\n\n\n\n
        4. If needed, it uses the tool<\/strong> and gets the result.<\/li>\n\n\n\n
        5. Finally, the model responds with the final answer<\/strong>.<\/li>\n<\/ol>\n\n\n\n
          This loop is what makes the tiny agent smart.<\/p>\n\n\n\n
          What the Code Looks Like<\/strong><\/h2>\n\n\n\n
          Here\u2019s a simple example of how the 50 lines might look in TypeScript:<\/p>\n\n\n\n
          tsCopyEditimport { createAgent } from '@mcp\/agent';\nimport { HfInference } from '@huggingface\/inference';\n\nconst hf = new HfInference(process.env.HF_API_KEY);\n\nconst tools = {\n  search: async (query: string) => {\n    const res = await fetch(`https:\/\/api.search.com?q=${query}`);\n    return await res.text();\n  }\n};\n\nconst agent = createAgent({\n  model: async (messages) => {\n    return await hf.chatCompletion({\n      model: 'meta-llama\/Llama-3-8B-Instruct',\n      messages\n    });\n  },\n  tools,\n  system: 'You are a smart AI agent. Use tools if needed.'\n});\n\n(async () => {\n  const userInput = 'What is the capital of Canada?';\n  const result = await agent.run(userInput);\n  console.log(result);\n})();\n<\/code><\/pre>\n\n\n\n
          What does this do?<\/p>\n\n\n\n
            \n
          • It sets up the Hugging Face AI model.<\/li>\n\n\n\n
          • It adds a search tool<\/strong> the agent can use.<\/li>\n\n\n\n
          • It runs the agent with one question.<\/li>\n\n\n\n
          • If the agent thinks it needs help, it uses the tool.<\/li>\n<\/ul>\n\n\n\n
            All of that in less than 50 lines<\/strong>!<\/p>\n\n\n\n
            How Do Tools Work in This Setup?<\/strong><\/h2>\n\n\n\n
            In your agent, tools are just simple functions<\/strong> you write.<\/p>\n\n\n\n
            Let\u2019s say you want a calculator. You create a function like this:<\/p>\n\n\n\n
            tsCopyEditconst tools = {\n  calculator: (input) => eval(input)\n};\n<\/code><\/pre>\n\n\n\n
            When someone asks, \u201cWhat\u2019s 45 x 3?\u201d<\/em>, the agent can use this tool to calculate the answer and then reply with it.<\/p>\n\n\n\n
            The model decides<\/strong> when to use a tool based on your message.<\/p>\n\n\n\n
            Taking It Further With MCP Servers<\/strong><\/h2>\n\n\n\n
            If you want more power, like long conversations or multiple tools, you can run an MCP server<\/strong>.<\/p>\n\n\n\n
            This is like giving your tiny agent a bigger brain.<\/p>\n\n\n\n
            Run it with:<\/p>\n\n\n\n
            bashCopyEditnpx mcp-server start\n<\/code><\/pre>\n\n\n\n
            It lets you:<\/p>\n\n\n\n
              \n
            • Use many tools at once<\/li>\n\n\n\n
            • Store memory for ongoing chats<\/li>\n\n\n\n
            • Connect with other apps using APIs<\/li>\n<\/ul>\n\n\n\n
              It\u2019s a bigger setup, but it gives your tiny agent even more abilities.<\/p>\n\n\n\n
              Why Use Hugging Face?<\/strong><\/h2>\n\n\n\n
              Hugging Face is a platform full of AI models. You can:<\/p>\n\n\n\n
                \n
              • Use powerful models like LLaMA 3<\/strong>, Falcon<\/strong>, and more<\/li>\n\n\n\n
              • Run them in the cloud<\/li>\n\n\n\n
              • Try them for free or pay as needed<\/li>\n<\/ul>\n\n\n\n
                It works really well with MCP and helps you keep your code light and clean.<\/p>\n\n\n\n
                Real-Life Uses for Tiny Agents<\/strong><\/h2>\n\n\n\n
                So what can you actually build?<\/p>\n\n\n\n
                  \n
                • Customer support bot<\/strong> for your website<\/li>\n\n\n\n
                • AI helper<\/strong> to check your calendar or emails<\/li>\n\n\n\n
                • A study assistant<\/strong> who can explain topics to you<\/li>\n\n\n\n
                • A search agent<\/strong> that finds info online and summarizes it<\/li>\n\n\n\n
                • Simple AI app<\/strong> for kids or elderly users<\/li>\n<\/ul>\n\n\n\n
                  Because it\u2019s so light, you can build fast and improve as you go.<\/p>\n\n\n\n
                  Tips for Success<\/strong><\/h2>\n\n\n\n
                  Here are a few tips to make your tiny agent even better:<\/p>\n\n\n\n
                    \n
                  • Write clear tool descriptions<\/strong> so the model knows what each tool does.<\/li>\n\n\n\n
                  • Keep tools simple<\/strong> at first\u2014focus on one function per tool.<\/li>\n\n\n\n
                  • Test often<\/strong> by sending different types of questions.<\/li>\n\n\n\n
                  • Use structured prompts<\/strong> (set the tone with a clear system message).<\/li>\n<\/ul>\n\n\n\n
                    Big Possibilities in Tiny Code<\/strong><\/h2>\n\n\n\n
                    You don\u2019t need 1,000 lines of code or a team of engineers to build a smart AI assistant. With Model Context Protocol (MCP)<\/strong> and Hugging Face<\/strong>, you can build a tiny agent that thinks and acts<\/strong>\u2014all in under 50 lines.<\/p>\n\n\n\n
                    Whether you’re learning, building a startup, or just having fun, tiny agents are a powerful way to explore what AI can do.<\/p>\n\n\n\n
                    Now it\u2019s your turn<\/strong>, go ahead and try building your tiny agent today. You\u2019ll be amazed at how much it can do with so little code.<\/p>","protected":false},"excerpt":{"rendered":"
                    Have you ever thought about building your own AI agent, something like ChatGPT that can do tasks, answer questions, and even use tools like a calculator or search engine? What if I told you that you can create one using only 50 lines of code? In this article, We\u2019ll walk you through how to build […]<\/p>\n","protected":false},"author":1,"featured_media":5764,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"_mi_skip_tracking":false,"footnotes":""},"categories":[64],"tags":[420,419],"ppma_author":[331],"class_list":{"0":"post-5763","1":"post","2":"type-post","3":"status-publish","4":"format-standard","5":"has-post-thumbnail","7":"category-ai","8":"tag-ai-agent","9":"tag-tiny-agents"},"authors":[{"term_id":331,"user_id":1,"is_guest":0,"slug":"pastakutmanwen","display_name":"Villpress Insider","avatar_url":{"url":"https:\/\/villpress.com\/wp-content\/uploads\/2025\/05\/Logo.png","url2x":"https:\/\/villpress.com\/wp-content\/uploads\/2025\/05\/Logo.png"},"0":null,"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/posts\/5763","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/comments?post=5763"}],"version-history":[{"count":1,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/posts\/5763\/revisions"}],"predecessor-version":[{"id":5765,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/posts\/5763\/revisions\/5765"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/media\/5764"}],"wp:attachment":[{"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/media?parent=5763"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/categories?post=5763"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/tags?post=5763"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/villpress.com\/cs\/wp-json\/wp\/v2\/ppma_author?post=5763"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}