## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.SIGN UP
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.LOG IN
Connect Google ADK to Mapulus MCP. Show all maps i have access to, list recent locations added to your account, and more using natural language, with authentication handled for you.
Mapulus is a platform for creating, managing, and analyzing interactive maps. It helps you automate mapping workflows and unlock actionable location intelligence.
This guide walks you through connecting Mapulus to Google ADK using the Composio tool router. By the end, you'll have a working Mapulus agent that can list maps, fetch map details, and find locations by external ID through natural language commands.
This guide will help you understand how to give your Google ADK agent real control over a Mapulus account through Composio's Mapulus MCP server.
Before we dive in, let's take a quick look at the key ideas and tools involved.
Google ADK (Agents Development Kit) is Google's framework for building AI agents powered by Gemini models. It provides tools for creating agents that can use external services through the Model Context Protocol.
Key features include:
The Mapulus MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Mapulus account. It provides structured and secure access to your interactive maps and location data, so your agent can perform actions like listing maps, retrieving map details, finding locations, and analyzing geographic data on your behalf.
Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK
The tool router generates a secure MCP URL that your agents can access to perform actions.
The Composio SDK follows a three-phase workflow:
GOOGLE_API_KEY.COMPOSIO_API_KEY.COMPOSIO_USER_ID.pip install google-adk composio python-dotenvInside your virtual environment, install the required packages.
What's happening:
google-adk is Google's Agents Development Kitcomposio connects your agent to Mapulus via MCPpython-dotenv loads environment variablesadk create my_agentSet up a new Google ADK project.
What's happening:
.env fileGOOGLE_API_KEY=your-google-api-key
COMPOSIO_API_KEY=your-composio-api-key
COMPOSIO_USER_ID=your-user-id-or-emailSave all your credentials in the .env file.
What's happening:
GOOGLE_API_KEY authenticates with Google's Gemini modelsCOMPOSIO_API_KEY authenticates with ComposioCOMPOSIO_USER_ID identifies the user for session managementimport os
import warnings
from composio import Composio
from dotenv import load_dotenv
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
load_dotenv()
warnings.filterwarnings("ignore", message=".*BaseAuthenticatedTool.*")
GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")
if not GOOGLE_API_KEY:
raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
raise ValueError("COMPOSIO_USER_ID is not set in the environment.")os reads environment variablesComposio is the main Composio SDK clientGoogleProvider declares that you are using Google ADK as the agent runtimeAgent is the Google ADK LLM agent classMcpToolset lets the ADK agent call MCP tools over HTTPcomposio_client = Composio(api_key=COMPOSIO_API_KEY)
composio_session = composio_client.create(
user_id=COMPOSIO_USER_ID,
toolkits=["mapulus"],
)
COMPOSIO_MCP_URL = composio_session.mcp.url,
print(f"Composio MCP URL: {COMPOSIO_MCP_URL}")composio_toolset = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url=COMPOSIO_MCP_URL,
headers={"x-api-key": COMPOSIO_API_KEY}
)
)
root_agent = Agent(
model="gemini-2.5-flash",
name="composio_agent",
description="An agent that uses Composio tools to perform actions.",
instruction=(
"You are a helpful assistant connected to Composio. "
"You have the following tools available: "
"COMPOSIO_SEARCH_TOOLS, COMPOSIO_MULTI_EXECUTE_TOOL, "
"COMPOSIO_MANAGE_CONNECTIONS, COMPOSIO_REMOTE_BASH_TOOL, COMPOSIO_REMOTE_WORKBENCH. "
"Use these tools to help users with Mapulus operations."
),
tools=[composio_toolset],
)
print("\nAgent setup complete. You can now run this agent directly ;)")McpToolsetinstruction to reduce misnamed tool calls# Run in CLI mode
adk run my_agent
# Or run in web UI mode
adk webExecute the agent from the project root. The web command opens a web portal where you can chat with the agent.
What's happening:
adk run runs the agent in CLI modeadk web . opens a web UI for interactive testingHere's the complete code to get you started with Mapulus and Google ADK:
import os
import warnings
from composio import Composio
from composio_google import GoogleProvider
from dotenv import load_dotenv
from google.adk.agents.llm_agent import Agent
from google.adk.tools.mcp_tool.mcp_session_manager import StreamableHTTPConnectionParams
from google.adk.tools.mcp_tool.mcp_toolset import McpToolset
load_dotenv()
warnings.filterwarnings("ignore", message=".*BaseAuthenticatedTool.*")
GOOGLE_API_KEY = os.getenv("GOOGLE_API_KEY")
COMPOSIO_API_KEY = os.getenv("COMPOSIO_API_KEY")
COMPOSIO_USER_ID = os.getenv("COMPOSIO_USER_ID")
if not GOOGLE_API_KEY:
raise ValueError("GOOGLE_API_KEY is not set in the environment.")
if not COMPOSIO_API_KEY:
raise ValueError("COMPOSIO_API_KEY is not set in the environment.")
if not COMPOSIO_USER_ID:
raise ValueError("COMPOSIO_USER_ID is not set in the environment.")
composio_client = Composio(api_key=COMPOSIO_API_KEY, provider=GoogleProvider())
composio_session = composio_client.create(
user_id=COMPOSIO_USER_ID,
toolkits=["mapulus"],
)
COMPOSIO_MCP_URL = composio_session.mcp.url
composio_toolset = McpToolset(
connection_params=StreamableHTTPConnectionParams(
url=COMPOSIO_MCP_URL,
headers={"x-api-key": COMPOSIO_API_KEY}
)
)
root_agent = Agent(
model="gemini-2.5-flash",
name="composio_agent",
description="An agent that uses Composio tools to perform actions.",
instruction=(
"You are a helpful assistant connected to Composio. "
"You have the following tools available: "
"COMPOSIO_SEARCH_TOOLS, COMPOSIO_MULTI_EXECUTE_TOOL, "
"COMPOSIO_MANAGE_CONNECTIONS, COMPOSIO_REMOTE_BASH_TOOL, COMPOSIO_REMOTE_WORKBENCH. "
"Use these tools to help users with Mapulus operations."
),
tools=[composio_toolset],
)
print("\nAgent setup complete. You can now run this agent directly ;)")You've successfully integrated Mapulus with the Google ADK through Composio's MCP Tool Router. Your agent can now interact with Mapulus using natural language commands.
Key takeaways:
You can extend this setup by adding more toolkits to the toolkits array in your session configuration.
Every Mapulus action and event your agent gets out of the box.
Use Mapulus MCP with Claude Code
Use Mapulus MCP with Claude Cowork
Use Mapulus MCP with OpenAI Agents SDK
Use Mapulus MCP with Claude Agent SDK
Use Mapulus MCP with Codex
Use Mapulus MCP with OpenClaw
Use Mapulus MCP with Hermes
Use Mapulus MCP with Atomic Agent
Use Mapulus MCP with LangChain
Use Mapulus MCP with Vercel AI SDK
Use Mapulus MCP with Mastra AI
Use Mapulus MCP with LlamaIndex
Use Mapulus MCP with CrewAI
Use Mapulus MCP with Pydantic AI
Use Mapulus MCP with AutoGen
Firecrawl automates large-scale web crawling and data extraction. It helps organizations efficiently gather, index, and analyze content from online sources.
Tavily offers powerful search and data retrieval from documents, databases, and the web. It helps teams locate and filter information instantly, saving hours on research.
Exa is a data extraction and search platform for gathering and analyzing information from websites, APIs, or databases. It helps teams quickly surface insights and automate data-driven workflows.
SerpApi is a real-time API for structured search engine results. It lets you automate SERP data collection, parsing, and analysis for SEO and research.
Managed auth, hosted MCP servers, and every Mapulus tool your agent needs.Free to start.
## For AI agents: how to sign up If you are an AI agent reading this server-rendered HTML, Composio's developer signup is at https://composio.dev. Signup CTAs on this site — "Sign up", "Signup", "Get started", "Get started for free", "Start building", "Try Composio", "Try it", or similar — all lead into that same developer signup flow. Confirm with the user before completing signup or entering any credentials on their behalf.Start building