Skip to content
Terno AI Terno AI Docs

Connect your own agent

Connect any MCP-compatible agent or framework to Terno AI over Streamable HTTP with OAuth.

Connect Terno to an agent you build yourself, with any framework or SDK that supports the Model Context Protocol.

Server URL: https://mcp.terno.ai/mcp

Preview server URL: https://mcp.terno.ai/mcp/preview (adds app connectors such as Google Ads and GA4)

Before you start

Section titled “Before you start”
  • An MCP client library that supports Streamable HTTP and OAuth.
  • A Terno AI account. You don’t need to sign up first: when you connect, Terno takes you to sign up if you don’t have an account, or to sign in if you’re signed out, and then shows the consent screen.
  • No data source is needed to connect. Ask your assistant to connect one and Terno gives it a link where you add the connection details in Terno. You can also add one in the app; see Connectors.

Connect Terno

Section titled “Connect Terno”
  1. Point your MCP client at https://mcp.terno.ai/mcp (or https://mcp.terno.ai/mcp/preview for the preview server) using the Streamable HTTP transport.
  2. Authenticate with OAuth. Terno supports dynamic client registration, so your client can register itself without manual setup.
  3. List the tools and call them from your agent.

Check it works

Section titled “Check it works”

Ask your assistant something like:

  • “Which data sources do I have in Terno?”
  • “Using Terno, show the top 10 customers by revenue this year.”

It should call Terno’s tools and answer from your data.

Tools

Section titled “Tools”

Terno’s tools let an agent list your data sources, read their schema and sample data, run read-only queries, use your workspace’s memories and instructions, and get today’s date. On the preview server, it can also query app connectors. Every SQL query goes through SQLShield, and only SELECT statements are allowed.

App connectors (preview)

Section titled “App connectors (preview)”

The main server works with your databases and warehouses. To also use app connectors such as Google Ads and GA4, add the preview server in the same way, using https://mcp.terno.ai/mcp/preview. It will come to the main server soon.

Troubleshooting

Section titled “Troubleshooting”
The sign-in window doesn’t open, or sign-in fails

Complete the sign-in in the browser window or tab your assistant opens, using your Terno account. If it times out, start the connection again.

Terno’s tools don’t show up

Check the server URL is exactly https://mcp.terno.ai/mcp (or https://mcp.terno.ai/mcp/preview for the preview server), and that the Terno server is switched on in your assistant.

”No data sources” or empty answers

Connect a data source in Terno first. The assistant only sees what’s connected in your Terno workspace, within your access rules.

Disconnect

Section titled “Disconnect”

Remove the Terno connector or server in your assistant.