Before you start
- A Microsoft 365 Copilot license on the account you'll test with.
- Custom app upload enabled for your tenant. Your Microsoft 365 admin controls this; the toolkit shows you whether it's on.
- Visual Studio Code with the Microsoft 365 Agents Toolkit extension, version 6.12.0 or later.
- An active SoftSignal subscription — the agent authenticates each person against their own SoftSignal account.
Steps
In Visual Studio Code, open the Microsoft 365 Agents Toolkit from the Activity Bar and choose Create a New Agent/App → Declarative Agent.
Choose Add an Action, then Start with an MCP Server, and enter this server URL:
https://chat.getsoftsignal.com/mcp
When the toolkit asks for an authentication type, pick OAuth (with dynamic registration). It will not ask you for a client ID or a secret — that's expected. The toolkit writes the registration into the plugin manifest for you.
Then give the agent a name and a folder, and let the toolkit generate the project.
In the toolkit's Accounts pane, sign in to Microsoft 365 and confirm that both Custom App Upload Enabled and Copilot Access Enabled appear under your account. If either is missing, your Microsoft 365 admin has to turn it on before you can continue.
Then open the Lifecycle pane and select Provision.
Go to m365.cloud.microsoft/chat and
find your agent in the Agents sidebar — during testing it appears with
dev appended to the name. Ask it anything and Copilot will prompt you to
sign in.
Enter your SoftSignal subscriber email and click the one-click sign-in link we email you. There's no password.
Try: "What is managed money positioning in cotton right now?" or "How does this week's Brazil coffee weather stress compare with the same week last year?"
Rolling it out to your organization
Provisioning from the toolkit installs the agent for you alone. To give it to a team, hand
the generated app package (the .zip the toolkit builds) to your Microsoft 365
admin, who uploads it under Integrated apps in the Microsoft 365 admin
center and assigns it to the people or groups who should see it.
What the agent can reach
Everything in the SoftSignal MCP catalog: CFTC positioning, USDA WASDE and PSD supply balances, crop progress and condition, US Drought Monitor, EIA storage and prices, ENSO and IOD state, our weather-stress and phenology series, CONAB, and the published report library. The manifest uses Copilot's dynamic tool discovery, so when we add a dataset it becomes available in your tenant without anyone republishing the agent.
SoftSignal is a standard remote MCP server over streamable HTTP at
https://chat.getsoftsignal.com/mcp, with OAuth 2.1 and dynamic client registration. Point
any MCP client at it — including Copilot Studio, the Agents SDK, or your own code. See
the API reference.
If something goes wrong
- The toolkit won't provision. Check the Accounts pane. Missing Custom App Upload Enabled is a tenant policy, not a bug — it needs your admin.
- The agent answers without data. Confirm you completed the SoftSignal sign-in prompt. Copilot will call the tools only after the connection is authorized.
- Sign-in loops. Remove and re-add the connector so it can register again, then retry.
- Anything else — email [email protected] and tell us what the toolkit reported.