First-party app
Fireberry Fireberry

Fireberry

Read, create, update, delete and query Fireberry CRM records across any object, and read object, field and picklist metadata.

stable Customer Relationship Management

About

Fireberry ships in the w6w first-party pack. It declares 14 actions, 3 health checks, and the host runs its code in a sandbox that never sees the credential.

App id
io.w6w.fireberry
Version
0.1.0
Author
w6w
Licence
MIT
Categories
Customer Relationship Management

Overview

Fireberry (formerly Powerlink) is a CRM for managing accounts, contacts, opportunities, tasks, support cases and custom objects. This app lists, reads, creates, updates and deletes records of any object, built-in or custom, by system name or object number, fetches related records, and batch-creates or batch-updates up to 20 records at a time.

It searches with Fireberry’s v3 query (filters, sorting, grouping and aggregation, up to 500 rows a page) and reads the metadata API: every object, an object’s fields, and a picklist field’s options.

Health checks verify the API access token, whether api.fireberry.com is answering, and Fireberry’s own status page.

Build with Fireberry

Three routes to the same 14 actions. The Workflow tab is generated from Fireberry's own manifest and carries its real ids, so it is copy-pasteable; the Code and CLI examples are the same call for any action on any app, so every app-specific value in them is a blank you fill in.

Get Field

field-get

Read one field's metadata by its system field name.

Get Object Fields

field-list

List an object's fields: label, system field name, field type ID and, for lookups, the related object. Use the system names in record and query calls.

Get Object

object-get

Read one object's metadata (name, system name, object number) by its number.

Get Objects

object-list

List every object in the CRM, built-in and custom, with its name, system name and object number.

Get Picklist Values

picklist-values

List a picklist field's options as name/value pairs. Records store the numeric value, so read this before writing a status, type or stage.

Query Records

query-records

Search, filter, sort, group and aggregate records of any object with Fireberry's v3 query. Pages of up to 500 rows; `isLastPage` says when to stop.

Create Record

record-create

Create a record in any object. Fields are a JSON object keyed by system field name, e.g. {"accountname": "Acme", "emailaddress1": "a@acme.test"}.

Delete Record

record-delete

Delete one record of any object by its GUID. This cannot be undone.

Get Record

record-get

Fetch one record of any object by its GUID, with all its fields.

List Records

record-list

List records of any object (accounts, contacts, opportunities, tasks, cases, custom objects) with all their fields, one page at a time. Limited to 10 pages of 50; use Query Records for filters and deeper paging.

List Related Records

record-list-related

List the records of one object that are related to a given record, e.g. the contacts of an account. Both objects are addressed by number.

Update Record

record-update

Update fields on an existing record of any object, addressed by its GUID.

Batch Create Records

records-batch-create

Create up to 20 records of one object in a single call. Records with invalid data are skipped while the valid ones are still created, so inspect the result. Not available on every licence.

Batch Update Records

records-batch-update

Update up to 20 records of one object in a single call. Records with invalid data are skipped while the valid ones are still updated, so inspect the result. Not available on every licence.

A workflow step names the app and the action, and the editor fills in the connection when you pick one. This is the Step shape from the workflow spec, carrying Fireberry's real ids.

{
  "manifestVersion": "2",
  "name": "fireberry-example",
  "steps": [
    {
      "id": "field-get",
      "uses": {
        "app": "io.w6w.fireberry",
        "action": "field-get",
        "connection": "conn_YOUR_CONNECTION_ID"
      },
      "with": {
        "objectNumber": "<objectNumber>",
        "fieldName": "<fieldName>"
      }
    }
  ]
}

Here are some of the things you can do

  • Get Field

    read
    field-get
  • Get Object Fields

    search
    field-list
  • Get Object

    read
    object-get
  • Get Objects

    search
    object-list
  • Get Picklist Values

    read
    picklist-values

+9 more actions available

Every app-specific value here is a blank you have to fill in. An app action is reached through the connection that authenticates it, so the address is a connection id, not the app id — and connections belong to your account, so a public page cannot know yours. Create one for Fireberry, then fill in the three blanks: conn_YOUR_CONNECTION_ID, the action key, and the parameters that action declares. The call itself is real — the shape is transcribed from the studio's own snippet builder, which prints the same kind of blanks — but nothing in it is specific to Fireberry. The Workflow tab is where this app's real ids are.

Install
npm install @w6w/sdk
yarn add @w6w/sdk
pnpm add @w6w/sdk
deno add npm:@w6w/sdk
Code
import { W6wClient, isActionRun } from "@w6w/sdk";

// Reads W6W_BASE_URL and W6W_TOKEN from the environment when omitted.
const client = new W6wClient();

const envelope = await client.run({
  urn: "conn_YOUR_CONNECTION_ID",
  action: "field-get",
  payload: {
    objectNumber: "<value>",
    fieldName: "<value>",
  },
});

if (isActionRun(envelope)) console.log(envelope.value);
Install the CLI
npm install -g @w6w/cli
CLI
w6w run conn_YOUR_CONNECTION_ID --action field-get --payload '{"objectNumber":"<value>","fieldName":"<value>"}'

Give an AI agent Fireberry — without giving it Fireberry's credentials. One MCP endpoint exposes every app, function and workflow the caller is entitled to, as tools it can discover and run. Access is granted per team while we onboard.

One tool call
{
  "name": "w6w_invoke",
  "arguments": {
    "ref": "app:io.w6w.fireberry#field-get",
    "input": {
      "objectNumber": "<objectNumber>",
      "fieldName": "<fieldName>"
    }
  }
}

Every tool names its target with a single ref. The app: form above doesn't name a connection at all — the host resolves which of the caller's Fireberry connections to sign with, and refuses rather than guesses when the answer is ambiguous.

What the agent gets

Credentials it can't read

The token is attached host-side, at the moment of the call. It is never a tool argument, never in the model's context, and never in a transcript — so a prompt injection has nothing to exfiltrate.

A tool surface scoped to the caller

Tools are derived per end user from what that person has actually connected and is entitled to — not one shared bot identity carrying the union of everyone's access.

A durable workflow in one call

Multi-step work runs on the workflow engine and returns a run handle the agent can poll — retries, branching and state survive the conversation that started them.

Health-aware discovery

Fireberry's declared health checks are on the surface too, so an agent can tell "the vendor is down" from "your credential expired" before it burns a retry on either.

The MCP surface is part of the hosted platform. Fireberry itself is MIT, and the runtime that executes it is source-available (FSL).

Request MCP access

Health checks

Fireberry declares its own checks, so its health is a property of the app rather than something the host guesses at.

service

Fireberry platform status

fireberry.statuspage.io (Statuspage v2). The `API` component decides; every other component is shown as detail only.

dependency

API reachability

Unauthenticated POST of api.fireberry.com/api/v3/query. Fireberry's JSON 401 is the expected healthy answer; token validity is the `auth:token` check's job.

quota

API request-rate headroom