MCP & Agent Setup
Connect an external agent to iMario, install its companion skill, or add capabilities to an individual.
Choose the connection you need
| Goal | Setup | Where it runs |
|---|---|---|
| Ask your iMario audiences from an external agent | Connect the iMario MCP server | Your MCP client calls the iMario workspace |
| Teach that agent the research workflow and result-reading rules | Install the iMario skill | The external agent reads a local SKILL.md |
| Give a synthetic individual an available tool capability | Connect Agent Skills | Inside iMario individual chat |
MCP provides callable tools. The companion skill supplies instructions for choosing an audience, estimating cost and reading results. Installing the skill does not connect the server or grant workspace access.
Individual Agent Skills have a separate assignment and account authorization flow. Installing a local skill in your external agent does not assign it to an iMario individual.
First successful setup
Connect MCP, verify that the client can list tools and accessible audiences, then install the companion skill if available. Listing tools is a connection check; submitting a study spends workspace credits. Ask for an estimate before deciding to run.
A study created over MCP appears in the workspace with a web_url. Keep that link with the results so you can inspect the study in iMario.
API keys → MCP client
imk_••••••••Transport: Streamable HTTP
URL: YOUR_MCP_ENDPOINT
Authorization: Bearer YOUR_KEY
Connect, verify, then decide to run
On an enabled deployment, use Settings → API keys. Choose credit limits.