For agents
Connect Groundtrace to your assistant
Groundtrace is an MCP server. Add it to Claude, ChatGPT, Muse, Claude Code, Cursor or your own agent, sign in once, and ask about US construction projects in plain words. Every answer names its sources.
The server
Every assistant connects to the same address:
https://api.groundtrace.io/mcpIt speaks MCP over Streamable HTTP. Sign-in is OAuth: your assistant opens Groundtrace’s sign-in page, you sign in to your Groundtrace account, and the assistant gets a token for it. If you have no Groundtrace account yet, sign up on that page: a new account starts on the free plan, 500 credits a month with every project and source but no contacts (pricing).
Claude
- In Claude (web, desktop or mobile), open Settings → Connectors and find Groundtrace in the directory. If it is not listed for you yet, choose Add custom connector and paste the server address above.
- Choose Connect and sign in to Groundtrace.
- Ask a question. Every tool only reads, so Claude can run them without asking each time.
In Claude Code, run this, then /mcp to sign in:
claude mcp add --transport http groundtrace https://api.groundtrace.io/mcpChatGPT
- In ChatGPT, open the directory of apps and plugins and search for Groundtrace. Until the listing is live, a workspace with developer mode on can add a custom MCP server with the address above.
- Choose Connect and sign in to Groundtrace.
- Mention Groundtrace in your question, or let ChatGPT pick it when you ask about construction projects.
Muse
Once Groundtrace is approved in Muse’s connector directory, find it there, choose Connect and sign in. In Muse Code, add it as a remote MCP server with the address above.
Cursor and other MCP clients
Add the server to the client’s MCP settings, for example in mcp.json:
{"mcpServers": {"groundtrace": {"url": "https://api.groundtrace.io/mcp"}}}A client that cannot sign in through OAuth can send an API token instead, as the header Authorization: Bearer <token>. Ask us for one at hello@groundtrace.io.
The tools
Five tools, all read-only: Groundtrace never creates, changes or sends anything.
search_projects: Find projects by industry, state, county, stage, size, construction start, builder or trade, ranked by how soon work is likely to start.enrich_projects: The full record of projects you already know, by id or by name.identify_org: A company by name or web domain: the projects it is named on and its role on each.get_evidence: The source behind any fact: the URL, when it was read and a short quote.describe_coverage: Which industries and states are covered, how many projects each has and how complete each field is.
Every fact comes back with a status (confirmed by two independent records, reported by one, predicted by our models, or not found) and the URLs of its sources. Predicted values are estimates, never facts. Contacts appear only where a public record or a professional page prints them, and only on a paid plan.
What to ask
- Which solar projects over 100 MW in Texas start construction before next summer, and who builds them?
- What is Mortenson building in Texas right now?
- Data centers in Virginia with a permit filed this year and no contractor named yet.
- Show me the source behind the builder on Meitner Solar.
- What changed on battery storage projects in California since October 1?
Privacy and support
When you connect, Groundtrace learns your account’s name and email and keeps a record of each call (the tool, what it asked and how many records came back); it never sees your conversation. The privacy page has the details and the terms say how answers may be used. To disconnect, remove Groundtrace in your assistant’s connector settings. For help, write to hello@groundtrace.io.