Connect Common Ninja to Your AI Agent

Choose a widget to retrieve its embed snippet or inspect the configuration supported by its type.

13 tools API key

Try a Common Ninja Task

Copy a prompt into your agent with the oo Skill installed. Add your page links and source notes before running it.

oo Skill Common Ninja

Retrieve a Widget Embed Snippet

Read a widget and collect its HTML and script references.

/oo Common Ninja: Read Common Ninja widget [widget ID] and retrieve its embed code. Present the returned HTML and script for me to add to [website page].

Review a Widget’s Configuration Options

Read a widget type’s schema to prepare valid configuration.

/oo Common Ninja: Read Common Ninja widget type [type ID] and its schema. Explain the required configuration fields and options relevant to [desired widget behavior].

Start Working with Common Ninja

  1. Install OOMOL

    Set up oo CLI and the oo Skill in your agent.

    Install OOMOL →
  2. Connect Common Ninja

    Connect a Common Ninja Account API Key.

    Connect Common Ninja →
  3. Give Your Agent a Task

    Use /oo with the pages to read, the changes to make, and where to save the result.

    Connection Guide →

Choose Your Agent

  • Access to the widget or project you want to use.
  • Inspect the widget type schema before supplying configuration. List actions support documented limits rather than automatic pagination.

Common Ninja Tools

This connection reads projects, widgets, widget types, and type schemas and manages widgets and their embed or editor references.

Widgets and Integration References

Inspect widget types and retrieve embed or editor links.

Widget Changes

Create or update a widget with schema-compatible data.

13 tools

Get User

Get the authenticated Common Ninja account profile.

commonninja.get_user

List Widgets

List Common Ninja widgets with optional filters. Results exclude widget configuration; use get_widget to read it. Only documented list filters are supported; automatic pagination is not available.

commonninja.list_widgets

Get Widget

Get a Common Ninja widget, including its type-specific configuration.

commonninja.get_widget

Create Widget

Create a Common Ninja widget. Choose draft or published explicitly. Omit data to use the type defaults, or obtain its configuration schema with get_widget_type_schema.

commonninja.create_widget

Update Widget

Update selected Common Ninja widget fields. Omitted fields remain unchanged; configuration must match the widget type schema.

commonninja.update_widget

Delete Widget

Delete a Common Ninja widget. Set permanent to true only when it must be irrecoverably removed.

commonninja.delete_widget

Get Widget Embed Code

Get the HTML container and SDK script for embedding a Common Ninja widget.

commonninja.get_widget_embed_code

Get Widget Editor Url

Get a Common Ninja widget editor URL, which can be embedded in an iframe.

commonninja.get_widget_editor_url

List Widget Types

List Common Ninja widget types. Only documented limit and field selection are supported; automatic pagination is not available.

commonninja.list_widget_types

Get Widget Type

Get metadata for a Common Ninja widget type.

commonninja.get_widget_type

Get Widget Type Schema

Get the JSON Schema for a Common Ninja widget type before supplying widget configuration.

commonninja.get_widget_type_schema

List Projects

List Common Ninja projects. Only the documented limit is supported; automatic pagination is not available.

commonninja.list_projects

Get Project

Get a Common Ninja project by ID.

commonninja.get_project

Frequently Asked Questions

Does retrieving code install the widget?

It returns the HTML and script snippet. Add it to the intended website page separately.

Can I open the widget editor?

The editor URL operation returns a URL for the selected widget.

Can I create an unpublished widget?

Yes. Widget creation accepts draft or published status and configuration matching the widget type schema.

Connect Common Ninja

About Common Ninja ↗