Laravel MCP Example using Google Gemini Free API (AI Integration Demo)

What is Laravel MCP and Why Use It?

Laravel MCP (Model Control Pattern) is an architectural approach similar to MVC, designed to simplify AI model integration within Laravel projects. It helps you organize your AI calls and responses cleanly — perfect for integrating APIs like Google Gemini for text generation, summarization, or chatbots.

1) Install Laravel & Setup Gemini API

First, ensure Laravel is installed. Then, get your free Gemini API key from Google AI Studio.

composer create-project laravel/laravel gemini-demo cd gemini-demo php artisan serve # Add your API key in .env GEMINI_API_KEY=your_google_gemini_api_key

2) Create MCP Structure & Controller

Now, let’s create a new MCP directory and a controller to handle Gemini API calls.

php artisan make:controller MCP/GeminiController

GeminiController.php

namespace App\Http\Controllers\MCP; use Illuminate\Http\Request; use Illuminate\Support\Facades\Http; use App\Http\Controllers\Controller; class GeminiController extends Controller { public function generate(Request $request) { $prompt = $request->input('prompt', 'Hello Gemini!'); $response = Http::withHeaders([ 'Content-Type' => 'application/json', ])->post('https://generativelanguage.googleapis.com/v1beta/models/gemini-1.5-flash-latest:generateContent?key=' . env('GEMINI_API_KEY'), [ 'contents' => [ ['parts' => [['text' => $prompt]]] ] ]); return response()->json($response->json()); } }

3) Add Route & Test in Browser

Finally, register the route and test your AI endpoint.

// routes/web.php use App\Http\Controllers\MCP\GeminiController; Route::post('/ai/generate', [GeminiController::class, 'generate']);

Now run your app and test using Postman or Axios in frontend:

axios.post('/ai/generate', { prompt: "Write a Laravel blog intro" }) .then(res => console.log(res.data)) .catch(err => console.error(err));

FAQ

Q1: Is Google Gemini API free?
Yes, Google offers a free tier via Gemini Flash model using API key.

Q2: Can I use this with Laravel 11?

Absolutely. This demo works on Laravel 10 and 11 versions.

Q3: Can I modify this to generate images?

Currently, Gemini API focuses on text-based AI tasks. For image generation, try Gemini 1.5 Pro or other APIs like OpenAI or Stability.

That’s it! You’ve successfully created a Laravel MCP demo using Google Gemini Free API. Try expanding it into an AI blog writer, chatbot, or code assistant.