Docs

Choose your preferred AI platform and authentication method to get started with Agentsfera.

TypeScript SDK

Agentsfera TypeScript SDK

The Agentsfera TypeScript SDK provides a modern, type-safe client for integrating MCP functionality into Node.js applications, browser-based tools, and server-side JavaScript projects. Built on the official Model Context Protocol SDK, it enables seamless access to 500+ business integrations through a clean, Promise-based API.

Why Use the TypeScript SDK?

Full Type Safety: Complete TypeScript definitions for all MCP operations, tools, and responses - catch errors at compile time.
Universal Compatibility: Works in Node.js, Bun, Deno, and modern browsers with full ESM support.
StreamableHTTP Transport: Efficient HTTP-based communication with built-in streaming for large responses and real-time data.
Session Management: Optional user-session-id headers maintain state across reconnections for stateful workflows.

Installation & Setup

Install via npm, yarn, pnpm, or bun. Authenticate with API keys passed in headers, then call tools from any of your enabled integrations using a unified interface.

Installation

Install the official MCP SDKs using your package manager:

npm install @modelcontextprotocol/sdk

TypeScript SDK

import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js"
import { Client } from "@modelcontextprotocol/sdk/client/index.js"

// Create MCP client
const client = new Client({
  name: "undefined",
  version: "1.0.0"
})

// Connect to the MCP server
await client.connect(new StreamableHTTPClientTransport(
  new URL("https://api.agentsfera.ai"),
  {
    requestInit: {
      headers: {
        "Authorization": "Bearer sk-7aefcd76-44c0-4687-a0a9-43599d050fdd",
        "Content-Type": "application/json",
        // Optional: Unique identifier for your user across MCP sessions
        // Use the same ID to maintain session continuity across reconnects
        "user-session-id": "your-user-unique-id"
      }
    }
  }
))

// List available tools from all enabled integrations
const { tools } = await client.listTools()
console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`)

// Example: Call a tool (adjust based on your enabled integrations)
const result = await client.callTool({
  name: "gmail-search-emails", // Gmail integration example
  arguments: {
    query: "project update",
    max_results: 10
  }
})

console.log("Tool result:", result)

// Tool result will contain a redirect URL to Google OAuth2 login page.
// You can customize the redirect URL to your application/agent.
// After that your application/agent will repeat the tool call.

No API keys found. Create an API key first to use the TypeScript SDK integration.

Agentsfera TypeScript SDK

Why Use the TypeScript SDK?

Full Type Safety: Complete TypeScript definitions for all MCP operations, tools, and responses - catch errors at compile time.
Universal Compatibility: Works in Node.js, Bun, Deno, and modern browsers with full ESM support.
StreamableHTTP Transport: Efficient HTTP-based communication with built-in streaming for large responses and real-time data.
Session Management: Optional user-session-id headers maintain state across reconnections for stateful workflows.

Installation & Setup

Install via npm, yarn, pnpm, or bun. Authenticate with API keys passed in headers, then call tools from any of your enabled integrations using a unified interface.

import { StreamableHTTPClientTransport } from "@modelcontextprotocol/sdk/client/streamableHttp.js" import { Client } from "@modelcontextprotocol/sdk/client/index.js" // Create MCP client const client = new Client({ name: "undefined", version: "1.0.0" }) // Connect to the MCP server await client.connect(new StreamableHTTPClientTransport( new URL("https://api.agentsfera.ai"), { requestInit: { headers: { "Authorization": "Bearer sk-7aefcd76-44c0-4687-a0a9-43599d050fdd", "Content-Type": "application/json", // Optional: Unique identifier for your user across MCP sessions // Use the same ID to maintain session continuity across reconnects "user-session-id": "your-user-unique-id" } } } )) // List available tools from all enabled integrations const { tools } = await client.listTools() console.log(`Available tools: ${tools.map(t => t.name).join(", ")}`) // Example: Call a tool (adjust based on your enabled integrations) const result = await client.callTool({ name: "gmail-search-emails", // Gmail integration example arguments: { query: "project update", max_results: 10 } }) console.log("Tool result:", result) // Tool result will contain a redirect URL to Google OAuth2 login page. // You can customize the redirect URL to your application/agent. // After that your application/agent will repeat the tool call.