Weavz
Socotra

Socotra

Automate Socotra policyholders, policies, claims, claim payables, policyholder invoices, lifecycle updates, and claim polling.

17 tools
1 trigger

Tools

Name
create_policyholder

Create a Socotra policyholder.

get_policyholder

Get a Socotra policyholder by locator.

update_policyholder

Update a Socotra policyholder by locator.

list_policyholder_policies

Fetch policies associated with one policyholder.

list_policyholder_invoices

Fetch invoice metadata associated with one policyholder.

create_policy

Create a Socotra policy from a policyholder and exposure payload.

get_policy

Get a Socotra policy by locator.

create_claim

Create a Socotra claim.

update_claim

Update a Socotra claim, including status changes such as open or closed where configured.

get_claim

Get a Socotra claim by locator.

list_claims

Find Socotra claims in a created timestamp range. Returns claim records without downloading media bodies.

list_policy_claims

Fetch all claims for a specific Socotra policy.

discard_claim

Discard a Socotra claim by exact locator.

create_claim_payable

Create a subclaim payable.

get_claim_payable

Get a Socotra claim payable by locator.

reverse_claim_payable

Reverse a Socotra claim payable.

overwrite_policyholder_data

Permanently overwrite specified policyholder fields; use only for documented expunge workflows.

Triggers

Name
claim_created_or_updated

Poll Socotra claims after an initial baseline using the claims date-range endpoint.

Quick Start

TypeScript
import { WeavzClient } from '@weavz-io/sdk'

const weavz = new WeavzClient({ apiKey: 'wvz_...' })

const result = await weavz.actions.execute('socotra', 'create_policyholder', {
  workspaceId: '550e8400-e29b-41d4-a716-446655440000',
  integrationAlias: 'socotra',
  input: { /* ... */ },
})

Related Integrations

Works well with

Frequently Asked Questions

How do I connect Socotra to my app?

Use Weavz Hosted Connect for Custom authentication. Install the SDK, create a connection through the connect portal or API, then execute tools programmatically.

What tools does Socotra support?

Socotra supports 17 tools including Create Policyholder, Policyholder, Update Policyholder, List Policyholder Policies, List Policyholder Invoices, and more.

Can I use Socotra with AI agents?

Yes. Add Socotra to an MCP server in Tool Mode or Code Mode. Code Mode provides 3 meta-tools with on-demand API discovery so agents can compose stateful workflows without loading every action schema up front.

Can Socotra be used in stateful agent workflows?

Yes. Agents can combine Socotra tools with Filesystem, State KV, Human Gates, input partials, and other workspace integrations while keeping execution scoped to the selected workspace or end user.

What authentication does Socotra use?

Socotra uses Custom. Weavz stores credentials securely and uses them for authorized action execution.

How much does the Socotra integration cost?

The Socotra integration is included on all Weavz plans including the free tier with 20,000 actions per month. No credit card required.

What triggers does Socotra support?

Socotra supports 1 triggers including Claim Created or Updated.

Connect Socotra in minutes

Get 20,000 free action executions every month. No credit card required.