# Sequence motif finder

- Human page: https://happytails.ai/en/developer-tools/sequence-motif-finder/
- Markdown: https://happytails.ai/en/developer-tools/sequence-motif-finder.md
- Structured JSON: https://happytails.ai/agents/en/developer-tools/sequence-motif-finder/index.json
- Visibility: public

## Tool capabilities

| Property | Value |
| --- | --- |
| Tool ID | `sequence-motif-finder` |
| Category | developer-tools |
| Implementation | Registered implementation. Registration alone is not a production-quality guarantee. |
| Browser execution | Use the visible action or interactive controls. |
| Browser processing | Browser; see tool notes for network behavior. |
| HTTP API | Not callable through HTTP. |
| Browser-agent interface | run_current_tool |

### Implementation notes

Searches every FASTA record case-insensitively and includes overlapping matches. Literal mode compares symbols exactly. Possible mode requires intersecting IUPAC base sets at every position. Certain mode requires every possible sequence base to be allowed by the motif. Both-strand mode also searches the reverse complement of the motif and reports coordinates on the original forward sequence. Palindromic motifs can produce two strand-specific rows at one position. Coordinates are one-based and inclusive. Only linear, gap-free DNA or RNA is supported; this is not alignment, homology, variant or biological significance analysis. Runs locally without uploads or database lookup. Limit: 500000 combined input characters, 2000 records, 2000 validation issues, a 1000-symbol motif, 20000 matches and 10000000 symbol comparisons. Exceeding a limit rejects the complete report. Each export is limited to 3000000 characters; typed CSV allows 200000 values. Preview shows 200 rows. Processing stops after 10 seconds.

### Inputs and settings

Text input: Your text.

Example or placeholder shown in the interface (not a validated fixture):

```text
Type or paste your input…
```

Up to 500,000 characters. Review the settings before running.

| Setting | Meaning | Control type | Default | Constraints |
| --- | --- | --- | --- | --- |
| `alphabet` | Sequence alphabet | select | "dna" | Allowed: dna, rna |
| `allowGaps` | Allow alignment gaps (-) | select | "false" | Allowed: false |
| `motif` | Motif | text | "ACG" |  |
| `mode` | Ambiguity matching | select | "possible" | Allowed: literal, possible, certain |
| `strands` | Search strands | select | "both" | Allowed: forward, both |

### Browser-agent workflow

1. Open the human page in a browser that supports WebMCP.
2. Discover the interface exposed by that page; use its actual schema.
3. Select files on the page first when the tool requires files.
4. Call `run_current_tool` with valid input and settings.
5. Inspect the returned result or error and the displayed output. Retrieve files from the displayed download links.

Calls do not automatically copy or download results. Browser permissions still apply. Interface availability alone is not proof of successful execution.

### Planning specification

Searches every FASTA record case-insensitively and includes overlapping matches. Literal mode compares symbols exactly. Possible mode requires intersecting IUPAC base sets at every position. Certain mode requires every possible sequence base to be allowed by the motif. Both-strand mode also searches the reverse complement of the motif and reports coordinates on the original forward sequence. Palindromic motifs can produce two strand-specific rows at one position. Coordinates are one-based and inclusive. Only linear, gap-free DNA or RNA is supported; this is not alignment, homology, variant or biological significance analysis. Runs locally without uploads or database lookup. Limit: 500000 combined input characters, 2000 records, 2000 validation issues, a 1000-symbol motif, 20000 matches and 10000000 symbol comparisons. Exceeding a limit rejects the complete report. Each export is limited to 3000000 characters; typed CSV allows 200000 values. Preview shows 200 rows. Processing stops after 10 seconds.

This describes intended requirements. Use the implementation notes, interface schema and observed output to determine current support.

### Complete machine-readable capability record

```json
{
  "id": "sequence-motif-finder",
  "category": "developer-tools",
  "built": true,
  "requirements": "Searches every FASTA record case-insensitively and includes overlapping matches. Literal mode compares symbols exactly. Possible mode requires intersecting IUPAC base sets at every position. Certain mode requires every possible sequence base to be allowed by the motif. Both-strand mode also searches the reverse complement of the motif and reports coordinates on the original forward sequence. Palindromic motifs can produce two strand-specific rows at one position. Coordinates are one-based and inclusive. Only linear, gap-free DNA or RNA is supported; this is not alignment, homology, variant or biological significance analysis. Runs locally without uploads or database lookup. Limit: 500000 combined input characters, 2000 records, 2000 validation issues, a 1000-symbol motif, 20000 matches and 10000000 symbol comparisons. Exceeding a limit rejects the complete report. Each export is limited to 3000000 characters; typed CSV allows 200000 values. Preview shows 200 rows. Processing stops after 10 seconds.",
  "implementation": {
    "fields": [
      {
        "key": "alphabet",
        "label": "Sequence alphabet",
        "value": "dna",
        "type": "select",
        "values": [
          "dna",
          "rna"
        ]
      },
      {
        "key": "allowGaps",
        "label": "Allow alignment gaps (-)",
        "value": "false",
        "type": "select",
        "values": [
          "false"
        ]
      },
      {
        "key": "motif",
        "label": "Motif",
        "value": "ACG",
        "type": "text",
        "maxLength": 1000,
        "help": "Use 1 to 1000 IUPAC symbols from the chosen DNA or RNA alphabet. No regular expressions, gaps or wildcards other than IUPAC symbols."
      },
      {
        "key": "mode",
        "label": "Ambiguity matching",
        "value": "possible",
        "type": "select",
        "values": [
          "literal",
          "possible",
          "certain"
        ]
      },
      {
        "key": "strands",
        "label": "Search strands",
        "value": "both",
        "type": "select",
        "values": [
          "forward",
          "both"
        ]
      }
    ],
    "registrationFamily": "sequence-tools",
    "presentation": "metrics",
    "note": "Searches every FASTA record case-insensitively and includes overlapping matches. Literal mode compares symbols exactly. Possible mode requires intersecting IUPAC base sets at every position. Certain mode requires every possible sequence base to be allowed by the motif. Both-strand mode also searches the reverse complement of the motif and reports coordinates on the original forward sequence. Palindromic motifs can produce two strand-specific rows at one position. Coordinates are one-based and inclusive. Only linear, gap-free DNA or RNA is supported; this is not alignment, homology, variant or biological significance analysis. Runs locally without uploads or database lookup. Limit: 500000 combined input characters, 2000 records, 2000 validation issues, a 1000-symbol motif, 20000 matches and 10000000 symbol comparisons. Exceeding a limit rejects the complete report. Each export is limited to 3000000 characters; typed CSV allows 200000 values. Preview shows 200 rows. Processing stops after 10 seconds.",
    "inputMaxLength": 500000,
    "inputErrorCode": "SEQUENCE_INPUT",
    "example": {
      "input": ">sample unchanged description\nACGTrynACGT\n",
      "options": {
        "alphabet": "dna",
        "allowGaps": "false",
        "motif": "ACG",
        "mode": "possible",
        "strands": "both"
      }
    },
    "experience": {
      "automatic": false,
      "single": false,
      "inputMaxLength": 500000,
      "inputMode": "text",
      "label": "Your text",
      "placeholder": "Type or paste your input…",
      "help": "Up to 500,000 characters. Review the settings before running.",
      "action": null
    },
    "mode": "explicit",
    "interactive": false
  },
  "execution": "Browser interface",
  "api": null,
  "browser_agent": {
    "supported": true,
    "name": "run_current_tool",
    "discovery": "WebMCP on the human page in a supporting browser",
    "verification": "See audit/API-AUDIT.md; availability is not verification"
  }
}
```

## Page guide

Locate overlapping literal or ambiguity-coded motifs in DNA or RNA FASTA, with explicit strand and matching rules.

How can we improve this tool?

Report a problem or share an idea.

Please leave out private information. Your message and the tool name go to our team via PostHog.

### How to use Sequence motif finder

1. Paste gap-free DNA or RNA FASTA and enter an IUPAC motif.
2. Choose literal, possible or certain matching and one or both strands.
3. Review inclusive forward-source coordinates and download every match.

## Useful next steps

- [FASTA validator](https://happytails.ai/en/developer-tools/fasta-validator/) ([Markdown](https://happytails.ai/en/developer-tools/fasta-validator.md))

- [FASTA sequence extractor](https://happytails.ai/en/developer-tools/fasta-sequence-extractor/) ([Markdown](https://happytails.ai/en/developer-tools/fasta-sequence-extractor.md))

- [Sequence reverse complement](https://happytails.ai/en/developer-tools/sequence-reverse-complement/) ([Markdown](https://happytails.ai/en/developer-tools/sequence-reverse-complement.md))

## Define ambiguity matching

Literal mode compares symbols. Possible mode accepts intersecting base sets. Certain mode requires every possible sequence base to be included in the motif.

### Interpret strand rows explicitly

Both-strand mode searches the motif and its reverse complement. Overlapping matches are retained; palindromic motifs can produce two rows at one position. Matches do not establish biological significance.
