Exa

​

Prerequisites

• Sign up and authenticate with Meshagent
• Obtain an Exa API Key

​

Required Environment Variables

• EXA_API_KEY=your-api-key-here   (Exa API authentication)

​

Steps

1. Install Meshagent CLI
   Copy

   Ask AI

   pip install "meshagent[all]"
   

2. Authenticate with Meshagent Follow onboarding steps at Meshagent CLI Getting Started.
3. Launch Exa MCP Agent in a Room
   Copy

   Ask AI

   meshagent service test \
     --room=test \
     --role=agent \
     --image=meshagent/mcp-exa:latest \
     --env EXA_API_KEY=your-api-key-here \
     --env MESHAGENT_PORT=8001 \
     --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
     --name=mcp-exa-service-test
   

   • Starts an Exa MCP server as an agent within the test Room. Room and services are temporary and will be cleaned up after inactivity.
4. Join a Chatbot Linked to the Exa Toolkit
   Copy

   Ask AI

   meshagent chatbot join \
     --room=test \
     --agent-name=mcp-exa \
     --name=mcp-exa \
     --toolkit=mcp-exa
   

   • Spawns a chatbot in the Room capable of using the Exa MCP toolkit. Multiple agents/tools can be combined in a Room.
   • The command output will include a browser link to the live Room.
5. Test the Integration
   • Visit the provided Room URL and initiate a conversation with the mcp-exa agent to try out the Exa web search tools.

​

Project Level Deployment: Persistent MCP Tooling

​

Persistent Agent and Chatbot Services

1. Create the Exa MCP Agent Service
   Copy

   Ask AI

   meshagent service create \
     --role=agent \
     --image=meshagent/mcp-exa:latest \
     --env EXA_API_KEY=your-api-key-here \
     --env MESHAGENT_PORT=8001 \
     --port="num=8001 path=/webhook liveness=/ type=meshagent.callable" \
     --name=mcp-exa-service
   

2. Create a Persistent Chatbot Linked to the Exa Toolkit
   Copy

   Ask AI

   meshagent service create \
     --image="meshagent/cli:latest" \
     --port="num=9001 path=/agent liveness=/ type=meshagent.callable participant_name=mcp-exa-chatbot" \
     --env="MESHAGENT_PORT=9001" \
     --name="mcp-exa-chatbot-service" \
     --command="meshagent chatbot service --agent-name=mcp-exa-chatbot --toolkit=mcp-exa"
   

​

Tools Available

​

Tools Provided

​

Tool Details

​

web_search_exa

​

Meshagent and Docker Links

• Meshagent: https://www.meshagent.com/
• Read The Docs: https://docs.meshagent.com
• Meshagent MCP Exa Tool Docker Image: https://hub.docker.com/r/meshagent/mcp-exa