Skip to content

Commit 712db32

Browse files
authored
Merge pull request #111 from second-state/alabulei1-patch-1
day 15
2 parents 4cd7b6c + bc16048 commit 712db32

File tree

2 files changed

+87
-2
lines changed

2 files changed

+87
-2
lines changed

doc/dev/2025-12-10-echokit-day-14-personality.md

Lines changed: 3 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,6 @@ Be philosophical but humorous.
9595

9696
Have fun — EchoKit becomes a completely different creature depending on what you choose.
9797

98-
---
9998

10099
## **Prompt Debugging Tips**
101100

@@ -108,9 +107,11 @@ If your character “breaks,” try adding:
108107

109108
Prompt tuning is an art. A few careful sentences can reshape the entire interaction.
110109

111-
112110
Try giving your EchoKit different personalities now.
113111

112+
---
113+
114+
114115
Want to explore more or share what you’ve built?
115116

116117
* Join the **[EchoKit Discord](https://discord.gg/Fwe3zsT5g3)**
Lines changed: 84 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,84 @@
1+
---
2+
slug: echokit-30-days-day-15-mcp-web-search
3+
title: "Day 15: EchoKit × MCP — Search the Web with Your Voice | The First 30 Days with EchoKit"
4+
tags: [echokit30days]
5+
---
6+
7+
8+
9+
10+
Over the past few days in The First 30 Days with EchoKit, we’ve explored how EchoKit connects to various LLM providers—OpenAI, OpenRouter, Groq, Grok and even local models. But switching models only affects how smart EchoKit is.
11+
12+
Next, we showed how changing the system prompt can transform EchoKit’s personality without touching any code—turning it into a coach, a cat, or a Shakespearean actor. Today, we’re going to extend what EchoKit can do by plugging into the broader ecosystem of tools through the Model Context Protocol (MCP).
13+
14+
Recent industry news makes this especially timely: on December 9, 2025, Anthropic donated MCP to the Linux Foundation and co‑founded the Agentic AI Foundation (AAIF) with Block and OpenAI. MCP is now joined by Block’s Goose agent framework and OpenAI’s AGENTS.md spec as the founding projects of the AAIF.
15+
16+
## 🧠 What is MCP?
17+
18+
MCP acts like a “USB‑C port” for AI agents. It defines a client–server protocol that lets models call external tools, databases or APIs through standardised actions. MCP servers wrap services—such as file systems, web searches or device controls—behind simple JSON‑RPC endpoints. MCP Clients (like EchoKit or Anthropic’s Claude Code) connect to one or more MCP servers and dynamically discover available tools. When the model needs information or wants to perform an action, it sends a tool request; the server executes the tool and returns results for the model to use
19+
20+
MCP’s adoption has been rapid: within a year of its release there were over 10,000 public MCP servers and more than 97 million SDK downloads. It’s been integrated into major platforms like ChatGPT, Claude, Cursor, Gemini, Microsoft Copilot and VS Code. By placing MCP under the AAIF, Anthropic and its partners ensure that this crucial infrastructure remains open, neutral and community‑driven.
21+
22+
## 🔧 Connect EchoKit to an MCP Server
23+
24+
To make EchoKit call external tools, we simply point it to an MCP server. Add a section like the following to your config.toml:
25+
26+
```
27+
[[llm.mcp_server]]
28+
server = "MCP_SERVER_URL"
29+
type = "http_streamable"
30+
```
31+
32+
server – the URL of the MCP server (replace this with the server you want to use).
33+
34+
type – http_streamable and SSE mode are supported.
35+
36+
Once configured, EchoKit will automatically maintain a connection to the MCP server. When the LLM detects that it needs to call a tool, it issues a request via MCP and merges the response into the LLM. So, if you want to use MCP server, the LLM you used must support tool call. Here are some recommendations:
37+
38+
* Open source models: Qwen3, GPT-OSS, Llama 3.1
39+
* Close source models: Gemini, OpenAI, Claude
40+
41+
## 🌐 Example: Adding a Web Search Tool
42+
43+
To demonstrate, let’s connect EchoKit to a web‑search MCP server. Many open‑source servers provide a search tool that scrapes public search engine results—often without requiring API keys.
44+
45+
Adding the server to your configuration. Here I use the GPT-OSS-120B model hosted on Groq and the tavily MCP server:
46+
```
47+
[llm]
48+
llm_chat_url = "https://api.groq.com/openai/v1/chat/completions"
49+
api_key = "YOUR API KEY"
50+
model = "openai/gpt-oss-120b"
51+
history = 5
52+
53+
[llm.mcp_server]]
54+
server = "http://eu.echokit.dev:8011/mcp"
55+
type = "http_streamable"
56+
```
57+
58+
59+
After that, save the file and restart EchoKit as usual.
60+
61+
Ask: “Tell me the latest update of MCP.”
62+
63+
Under the hood, EchoKit’s LLM recognises that it needs up‑to‑date information. It invokes the search tool on your MCP server, passing your query.
64+
65+
The MCP server performs the web search and returns structured results (titles, URLs and snippets). EchoKit then synthesises a natural‑language answer, summarising the findings and citing the sources.
66+
67+
You can also use other MCP sever tools like the Google Calendar MCP server to add and edit event, Slack MCP server to send an message to the Slack channel, Home Assistant MCP server to control the home device. All of these tools become accessible through your voice.
68+
69+
## 📌 Why This Matters
70+
71+
Integrating MCP gives EchoKit access to a rapidly expanding tool ecosystem. You’re no longer limited to predetermined voice commands; your agent can search the web, read files, run code, query databases or control smart devices—all through a the voice interface. The AAIF’s stewardship of MCP ensures that these capabilities remain open and interoperable, so EchoKit can continue to evolve alongside the broader agentic AI community.
72+
73+
---
74+
75+
Want to explore more or share what you’ve built with MCP servers?
76+
77+
* Join the **[EchoKit Discord](https://discord.gg/Fwe3zsT5g3)**
78+
79+
Ready to get your own EchoKit?
80+
81+
* **EchoKit Box →** [https://echokit.dev/echokit_box.html](https://echokit.dev/echokit_box.html)
82+
* **EchoKit DIY Kit →** [https://echokit.dev/echokit_diy.html](https://echokit.dev/echokit_diy.html)
83+
84+
**Start building your own voice AI agent today.**

0 commit comments

Comments
 (0)