vAST

Register a software statement

From your viaNexus account, request a software statement with the dataset patterns this agent can reach. For a news agent, include EDGE:MT_NEWSWIRES*.

The API returns a signed JWT. The SDK presents that JWT during MCP OAuth registration, and the MCP server enforces those permissions server-side.

Request

curl -X POST "https://api.blueskyapi.com/v1/agents/register?token=$VIANEXUS_API_TOKEN" \
      -H "Content-Type: application/json" \
      -d '{"expiresIn":"1h",
           "permissions":{"include":["EDGE:MT_NEWSWIRES*"]}}'

Response

{
  "success": true,
  "softwareStatement": "eyJhbGciOiJSUzI1NiIs..."
}

Save it as VIANEXUS_JWT in your env.

Install the SDK

One install pulls the framework, the MCP client, and the OAuth handler. No additional setup, no separate auth library.

Python 3.11+. We recommend uv for speed, but pip works just as well.

Wire the agent

One config dict. Pick a model, drop in the JWT from step 01, and let the factory wire up OAuth, MCP, and tool integration for you.

Switch providers later by changing the model name, the factory auto-detects Anthropic, OpenAI, or Google.

news_agent.py

from vianexus_agent_sdk.clients.llm_client_factory import LLMClientFactory
import os, asyncio

config = {
    "LLM_MODEL": "claude-3-5-sonnet-20241022",
    "LLM_API_KEY": os.getenv("ANTHROPIC_API_KEY"),
    "system_prompt": "You are a financial news analyst.",
    "agentServers": {
        "viaNexus": {
            "server_url": "https://vast-mcp.blueskyapi.com",
            "server_port": 443,
            "software_statement": os.getenv("VIANEXUS_JWT"),
        }
    },
}

async def main():
    client = LLMClientFactory.create_client(config)
    await client.initialize()
    answer = await client.ask_question(
        "What did Powell say about rates this week?"
    )
    print(answer)
    await client.cleanup()

asyncio.run(main())

Run it

The SDK presents your software statement to the auth server, gets a scoped access token, opens an MCP session, and exposes search + fetch to Claude.

Claude decides when to call them. The agent loop runs until the answer is ready, then closes the session.

Extend without redeploying

Subscribe to a fundamentals dataset later? Issue a new software statement with a broader permissions.include list.

Reconnect or refresh the client with the new statement. Code stays the same. The auth flow stays the same.