MCP Servers

Server Type: HTTP Client
URL: Auto-configured
Authentication: Configure per-request via agent instructions

Use the HTTP tool to make a GET request to:
https://api.openweathermap.org/data/2.5/weather?q=San Francisco&appid=YOUR_KEY

Parse the JSON response and extract temperature and conditions.

You have access to these tools:

1. HTTP Client: Make API requests
   - Use this to call external services
   - Example: Fetch data from REST APIs

2. File System: Read and write files
   - Use this to access uploaded files
   - Example: Read CSV file for processing

When you need to use a tool, clearly state your intention
and provide all required parameters.

Agent Thought: "I need to fetch the weather data. I'll use the HTTP tool."

Tool Call:
{
  "tool": "http_client",
  "method": "GET",
  "url": "https://api.weather.com/v1/current?city=SF",
  "headers": {
    "Authorization": "Bearer API_KEY"
  }
}

Tool Response:
{
  "temperature": 62,
  "conditions": "Partly Cloudy",
  "humidity": 65
}

Agent: "I received the weather data. Temperature is 62°F with partly cloudy conditions."

const express = require('express');
const app = express();
app.use(express.json());

// Tool: Send Email
app.post('/tools/send_email', async (req, res) => {
  const { to, subject, body } = req.body.parameters;

  try {
    await sendEmail(to, subject, body);
    res.json({
      success: true,
      message: `Email sent to ${to}`
    });
  } catch (error) {
    res.status(500).json({
      success: false,
      error: error.message
    });
  }
});

// Tool: Query Database
app.post('/tools/query_database', async (req, res) => {
  const { query } = req.body.parameters;

  try {
    const results = await database.query(query);
    res.json({
      success: true,
      data: results
    });
  } catch (error) {
    res.status(500).json({
      success: false,
      error: error.message
    });
  }
});

app.listen(3000);

{
  "tool": "tool_name",
  "parameters": {
    "param1": "value1",
    "param2": "value2"
  },
  "context": {
    "agent_loop_id": "loop_abc123",
    "execution_id": "exec_xyz789"
  }
}

{
  "success": true,
  "result": {
    "output": "Tool execution result",
    "metadata": {
      "execution_time_ms": 150
    }
  }
}

{
  "success": false,
  "error": {
    "code": "TOOL_ERROR",
    "message": "Description of what went wrong"
  }
}

app.use((req, res, next) => {
  const apiKey = req.headers['x-api-key'];
  if (apiKey !== process.env.MCP_API_KEY) {
    return res.status(401).json({ error: 'Unauthorized' });
  }
  next();
});

app.post('/tools/delete_user', async (req, res) => {
  // Check if agent loop has permission for this action
  const { agent_loop_id } = req.body.context;
  if (!hasPermission(agent_loop_id, 'delete_user')) {
    return res.status(403).json({ error: 'Forbidden' });
  }
  // ... proceed with deletion
});

HTTP Tool Usage:
- To fetch data: Specify method (GET), URL, and any headers
- The tool returns JSON responses
- Example: GET https://api.example.com/data

When calling the database tool, use this query format:
SELECT column1, column2 FROM table WHERE condition

The tool will return an array of objects with the selected columns.