> ## Documentation Index
> Fetch the complete documentation index at: https://docs.tracecat.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MISP

> Reference for the Tracecat MISP integration: registered actions, required secrets, expected inputs, and example workflow usage.

## Get attribute

Action ID: `tools.misp.get_attribute`

Retrieve a specific MISP indicator by its numeric attribute ID.

Reference: [https://www.misp-project.org/openapi/#tag/Attributes/operation/getAttributeById](https://www.misp-project.org/openapi/#tag/Attributes/operation/getAttributeById)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="attribute_id" type="integer" required>
  Numeric ID of the attribute to retrieve.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Get event

Action ID: `tools.misp.get_event`

Retrieve a complete MISP event by ID, including its attributes, objects, tags, and metadata.

Reference: [https://www.misp-project.org/openapi/#tag/Events/operation/getEventById](https://www.misp-project.org/openapi/#tag/Events/operation/getEventById)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="event_id" type="integer" required>
  Numeric ID of the event to retrieve.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="include_correlations" type="boolean">
  Include correlation data when supported by the MISP instance.

  Default: `false`.
</ParamField>

<ParamField path="include_sightings" type="boolean">
  Include sighting data when supported by the MISP instance.

  Default: `false`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Get galaxy

Action ID: `tools.misp.get_galaxy`

Retrieve a MISP galaxy and optionally include all of its clusters.

Reference: [https://www.misp-project.org/openapi/#tag/Galaxies/operation/getGalaxyById](https://www.misp-project.org/openapi/#tag/Galaxies/operation/getGalaxyById)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="galaxy_id" type="integer" required>
  Numeric ID of the galaxy to retrieve.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

<ParamField path="with_clusters" type="boolean">
  Include clusters associated with the galaxy.

  Default: `true`.
</ParamField>

## Get object

Action ID: `tools.misp.get_object`

Retrieve a specific MISP object and all of its grouped attributes.

Reference: [https://www.misp-project.org/openapi/#tag/Objects/operation/getObjectById](https://www.misp-project.org/openapi/#tag/Objects/operation/getObjectById)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="object_id" type="integer" required>
  Numeric ID of the object to retrieve.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Get taxonomy

Action ID: `tools.misp.get_taxonomy`

Retrieve a MISP taxonomy with its predicates and values.

Reference: [https://www.misp-project.org/openapi/#tag/Taxonomies/operation/getTaxonomyById](https://www.misp-project.org/openapi/#tag/Taxonomies/operation/getTaxonomyById)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="taxonomy_id" type="integer" required>
  Numeric ID of the taxonomy to retrieve.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## List taxonomies

Action ID: `tools.misp.list_taxonomies`

List MISP taxonomy vocabularies used to classify threat intelligence.

Reference: [https://www.misp-project.org/openapi/#tag/Taxonomies/operation/getTaxonomies](https://www.misp-project.org/openapi/#tag/Taxonomies/operation/getTaxonomies)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search attributes

Action ID: `tools.misp.search_attributes`

Search individual MISP indicators across events for threat enrichment.

Reference: [https://www.misp-project.org/openapi/#tag/Attributes/operation/restSearchAttributes](https://www.misp-project.org/openapi/#tag/Attributes/operation/restSearchAttributes)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="category" type="string | null">
  MISP attribute category.

  Default: `null`.
</ParamField>

<ParamField path="date_from" type="string | null">
  Earliest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="date_to" type="string | null">
  Latest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="enforce_warninglist" type="boolean | null">
  Exclude attributes matching enabled warning lists.

  Default: `null`.
</ParamField>

<ParamField path="eventid" type="integer | array[integer] | null">
  Parent event ID or list of event IDs.

  Default: `null`.
</ParamField>

<ParamField path="include_correlations" type="boolean">
  Include correlation data.

  Default: `false`.
</ParamField>

<ParamField path="include_decay_score" type="boolean">
  Include indicator decay scores.

  Default: `false`.
</ParamField>

<ParamField path="include_event_tags" type="boolean">
  Include parent event tags.

  Default: `false`.
</ParamField>

<ParamField path="include_event_uuid" type="boolean">
  Include the parent event UUID.

  Default: `true`.
</ParamField>

<ParamField path="include_sightings" type="boolean">
  Include sighting data.

  Default: `false`.
</ParamField>

<ParamField path="limit" type="integer">
  Maximum number of attributes to return.

  Default: `50`.
</ParamField>

<ParamField path="org" type="string | null">
  Creator organisation name or ID.

  Default: `null`.
</ParamField>

<ParamField path="page" type="integer">
  Result page number.

  Default: `1`.
</ParamField>

<ParamField path="published" type="boolean | null">
  Filter by parent event publication state.

  Default: `null`.
</ParamField>

<ParamField path="tags" type="array[string] | null">
  Attribute tags to include or exclude.

  Default: `null`.
</ParamField>

<ParamField path="to_ids" type="boolean | null">
  Filter attributes by their IDS flag.

  Default: `null`.
</ParamField>

<ParamField path="type_attribute" type="string | null">
  MISP attribute type such as ip-src, domain, url, md5, or sha256.

  Default: `null`.
</ParamField>

<ParamField path="value" type="string | null">
  Indicator value such as an IP address, domain, URL, or hash.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search event index

Action ID: `tools.misp.search_event_index`

Browse and filter lightweight MISP event metadata without loading full attributes or objects.

Reference: [https://www.misp-project.org/openapi/#tag/Events/operation/searchEvents](https://www.misp-project.org/openapi/#tag/Events/operation/searchEvents)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="analysis" type="integer | null">
  Analysis level where 0 is initial, 1 ongoing, and 2 complete.

  Default: `null`.
</ParamField>

<ParamField path="attribute" type="string | null">
  Match events containing this attribute value.

  Default: `null`.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="date_from" type="string | null">
  Earliest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="date_to" type="string | null">
  Latest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="desc" type="boolean | null">
  Sort descending when true or ascending when false.

  Default: `null`.
</ParamField>

<ParamField path="eventid" type="string | null">
  Event ID filter.

  Default: `null`.
</ParamField>

<ParamField path="eventinfo" type="string | null">
  Text to match in the event information field.

  Default: `null`.
</ParamField>

<ParamField path="limit" type="integer">
  Maximum number of events to return.

  Default: `25`.
</ParamField>

<ParamField path="minimal" type="boolean">
  Return the minimal event metadata shape.

  Default: `false`.
</ParamField>

<ParamField path="org" type="string | null">
  Creator organisation name or ID.

  Default: `null`.
</ParamField>

<ParamField path="page" type="integer">
  Result page number.

  Default: `1`.
</ParamField>

<ParamField path="publish_timestamp" type="string | null">
  Filter by publication timestamp or relative time.

  Default: `null`.
</ParamField>

<ParamField path="published" type="boolean | null">
  Filter by event publication state.

  Default: `null`.
</ParamField>

<ParamField path="sort" type="string | null">
  Sort field such as id, date, or attribute\_count.

  Default: `null`.
</ParamField>

<ParamField path="tags" type="array[string] | null">
  Event tags to include or exclude.

  Default: `null`.
</ParamField>

<ParamField path="threatlevel" type="integer | null">
  Threat level where 1 is high, 2 medium, 3 low, and 4 undefined.

  Default: `null`.
</ParamField>

<ParamField path="timestamp" type="string | null">
  Filter by last-modified timestamp or relative time.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search events

Action ID: `tools.misp.search_events`

Search MISP events by indicators, tags, dates, organisation, and publication state.

Reference: [https://www.misp-project.org/openapi/#tag/Events/operation/restSearchEvents](https://www.misp-project.org/openapi/#tag/Events/operation/restSearchEvents)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="category" type="string | null">
  MISP attribute category.

  Default: `null`.
</ParamField>

<ParamField path="date_from" type="string | null">
  Earliest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="date_to" type="string | null">
  Latest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="enforce_warninglist" type="boolean | null">
  Exclude attributes matching enabled warning lists.

  Default: `null`.
</ParamField>

<ParamField path="event_tags" type="array[string] | null">
  Event-level tags to include or exclude.

  Default: `null`.
</ParamField>

<ParamField path="eventid" type="integer | array[integer] | null">
  Event ID or list of event IDs.

  Default: `null`.
</ParamField>

<ParamField path="eventinfo" type="string | null">
  Text to match in the event information field.

  Default: `null`.
</ParamField>

<ParamField path="include_correlations" type="boolean">
  Include correlation data.

  Default: `false`.
</ParamField>

<ParamField path="include_sightings" type="boolean">
  Include sighting data.

  Default: `false`.
</ParamField>

<ParamField path="limit" type="integer">
  Maximum number of events to return.

  Default: `25`.
</ParamField>

<ParamField path="metadata" type="boolean">
  Return event metadata without attributes or objects.

  Default: `false`.
</ParamField>

<ParamField path="org" type="string | null">
  Creator organisation name or ID.

  Default: `null`.
</ParamField>

<ParamField path="page" type="integer">
  Result page number.

  Default: `1`.
</ParamField>

<ParamField path="published" type="boolean | null">
  Filter by event publication state.

  Default: `null`.
</ParamField>

<ParamField path="quick_filter" type="string | null">
  Quick text search across event and attribute fields.

  Default: `null`.
</ParamField>

<ParamField path="tags" type="array[string] | null">
  Attribute tags to include or exclude.

  Default: `null`.
</ParamField>

<ParamField path="to_ids" type="boolean | null">
  Filter attributes by their IDS flag.

  Default: `null`.
</ParamField>

<ParamField path="type_attribute" type="string | null">
  MISP attribute type such as ip-src, domain, url, md5, or sha256.

  Default: `null`.
</ParamField>

<ParamField path="value" type="string | null">
  Indicator value such as an IP address, domain, URL, or hash.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search feeds

Action ID: `tools.misp.search_feeds`

List configured MISP feeds or search their cached threat intelligence for an indicator.

Reference: [https://www.misp-project.org/openapi/#tag/Feeds](https://www.misp-project.org/openapi/#tag/Feeds)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="value" type="string | null">
  Indicator to search in cached feeds. Omit to list configured feeds.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search galaxies

Action ID: `tools.misp.search_galaxies`

Search MISP galaxies for threat actors, malware, tools, and ATT\&CK knowledge bases.

Reference: [https://www.misp-project.org/openapi/#tag/Galaxies/operation/searchGalaxies](https://www.misp-project.org/openapi/#tag/Galaxies/operation/searchGalaxies)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="value" type="string" required>
  Text to match in galaxy names and descriptions.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

<ParamField path="with_clusters" type="boolean">
  Request cluster data with matching galaxies when supported.

  Default: `false`.
</ParamField>

## Search galaxy clusters

Action ID: `tools.misp.search_galaxy_clusters`

Search threat actors, malware families, techniques, and other clusters within a MISP galaxy.

Reference: [https://www.misp-project.org/openapi/#tag/Galaxy-Clusters/operation/searchGalaxyClusters](https://www.misp-project.org/openapi/#tag/Galaxy-Clusters/operation/searchGalaxyClusters)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="galaxy_id" type="integer" required>
  Numeric ID of the galaxy to search.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="context" type="string | null">
  Optional MISP galaxy cluster context filter.

  Default: `null`.
</ParamField>

<ParamField path="search_term" type="string | null">
  Text to match in cluster names, descriptions, and synonyms.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search objects

Action ID: `tools.misp.search_objects`

Search MISP objects that group related indicators such as files, network connections, and emails.

Reference: [https://www.misp-project.org/openapi/#tag/Objects/operation/restSearchObjects](https://www.misp-project.org/openapi/#tag/Objects/operation/restSearchObjects)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="category" type="string | null">
  MISP attribute category.

  Default: `null`.
</ParamField>

<ParamField path="date_from" type="string | null">
  Earliest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="date_to" type="string | null">
  Latest event date in YYYY-MM-DD format.

  Default: `null`.
</ParamField>

<ParamField path="eventid" type="integer | array[integer] | null">
  Parent event ID or list of event IDs.

  Default: `null`.
</ParamField>

<ParamField path="limit" type="integer">
  Maximum number of objects to return.

  Default: `25`.
</ParamField>

<ParamField path="object_name" type="string | null">
  Object template name such as file, ip-port, domain-ip, or email.

  Default: `null`.
</ParamField>

<ParamField path="org" type="string | null">
  Creator organisation name or ID.

  Default: `null`.
</ParamField>

<ParamField path="page" type="integer">
  Result page number.

  Default: `1`.
</ParamField>

<ParamField path="tags" type="array[string] | null">
  Tags to include or exclude.

  Default: `null`.
</ParamField>

<ParamField path="type_attribute" type="string | null">
  Type of an attribute contained in an object.

  Default: `null`.
</ParamField>

<ParamField path="value" type="string | null">
  Value of an attribute contained in an object.

  Default: `null`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>

## Search tags

Action ID: `tools.misp.search_tags`

Search MISP tags by exact or partial tag name.

Reference: [https://www.misp-project.org/openapi/#tag/Tags/operation/searchTag](https://www.misp-project.org/openapi/#tag/Tags/operation/searchTag)

### Secrets

Required secrets:

* `misp`: required values `MISP_API_KEY`.

### Input fields

<ParamField path="tagname" type="string" required>
  Exact or partial tag name, such as tlp:amber or a galaxy tag.
</ParamField>

<ParamField path="base_url" type="string | null">
  MISP base URL. Falls back to VARS.misp.base\_url.

  Default: `null`.
</ParamField>

<ParamField path="strict" type="boolean">
  Match the tag name exactly instead of matching synonyms and galaxy values.

  Default: `false`.
</ParamField>

<ParamField path="verify_ssl" type="boolean">
  Whether to verify SSL certificates.

  Default: `true`.
</ParamField>
